Rename “OS X” to the newer “macOS” convention
This commit is contained in:
parent
0de7cc848e
commit
989c8990bb
10 changed files with 34 additions and 34 deletions
|
@ -52,7 +52,7 @@ There are also [regression and integration tests](/test), written
|
||||||
in Python, that are run automatically on the build server.
|
in Python, that are run automatically on the build server.
|
||||||
These tests can be run (if the [test dependencies](/test) are installed) with: `test/functional/test_runner.py`
|
These tests can be run (if the [test dependencies](/test) are installed) with: `test/functional/test_runner.py`
|
||||||
|
|
||||||
The Travis CI system makes sure that every pull request is built for Windows, Linux, and OS X, and that unit/sanity tests are run automatically.
|
The Travis CI system makes sure that every pull request is built for Windows, Linux, and macOS, and that unit/sanity tests are run automatically.
|
||||||
|
|
||||||
### Manual Quality Assurance (QA) Testing
|
### Manual Quality Assurance (QA) Testing
|
||||||
|
|
||||||
|
|
|
@ -5,7 +5,7 @@ Upstart: bitcoind.conf
|
||||||
OpenRC: bitcoind.openrc
|
OpenRC: bitcoind.openrc
|
||||||
bitcoind.openrcconf
|
bitcoind.openrcconf
|
||||||
CentOS: bitcoind.init
|
CentOS: bitcoind.init
|
||||||
OS X: org.bitcoin.bitcoind.plist
|
macOS: org.bitcoin.bitcoind.plist
|
||||||
```
|
```
|
||||||
have been made available to assist packagers in creating node packages here.
|
have been made available to assist packagers in creating node packages here.
|
||||||
|
|
||||||
|
|
|
@ -22,7 +22,7 @@ Common `host-platform-triplets` for cross compilation are:
|
||||||
|
|
||||||
- `i686-w64-mingw32` for Win32
|
- `i686-w64-mingw32` for Win32
|
||||||
- `x86_64-w64-mingw32` for Win64
|
- `x86_64-w64-mingw32` for Win64
|
||||||
- `x86_64-apple-darwin11` for MacOSX
|
- `x86_64-apple-darwin11` for macOS
|
||||||
- `arm-linux-gnueabihf` for Linux ARM 32 bit
|
- `arm-linux-gnueabihf` for Linux ARM 32 bit
|
||||||
- `aarch64-linux-gnu` for Linux ARM 64 bit
|
- `aarch64-linux-gnu` for Linux ARM 64 bit
|
||||||
|
|
||||||
|
@ -49,7 +49,7 @@ The following can be set when running make: make FOO=bar
|
||||||
|
|
||||||
SOURCES_PATH: downloaded sources will be placed here
|
SOURCES_PATH: downloaded sources will be placed here
|
||||||
BASE_CACHE: built packages will be placed here
|
BASE_CACHE: built packages will be placed here
|
||||||
SDK_PATH: Path where sdk's can be found (used by OSX)
|
SDK_PATH: Path where sdk's can be found (used by macOS)
|
||||||
FALLBACK_DOWNLOAD_PATH: If a source file can't be fetched, try here before giving up
|
FALLBACK_DOWNLOAD_PATH: If a source file can't be fetched, try here before giving up
|
||||||
NO_QT: Don't download/build/cache qt and its dependencies
|
NO_QT: Don't download/build/cache qt and its dependencies
|
||||||
NO_WALLET: Don't download/build/cache libs needed to enable the wallet
|
NO_WALLET: Don't download/build/cache libs needed to enable the wallet
|
||||||
|
@ -64,7 +64,7 @@ options will be passed to bitcoin's configure. In this case, `--disable-wallet`.
|
||||||
Additional targets:
|
Additional targets:
|
||||||
|
|
||||||
download: run 'make download' to fetch all sources without building them
|
download: run 'make download' to fetch all sources without building them
|
||||||
download-osx: run 'make download-osx' to fetch all sources needed for osx builds
|
download-osx: run 'make download-osx' to fetch all sources needed for macOS builds
|
||||||
download-win: run 'make download-win' to fetch all sources needed for win builds
|
download-win: run 'make download-win' to fetch all sources needed for win builds
|
||||||
download-linux: run 'make download-linux' to fetch all sources needed for linux builds
|
download-linux: run 'make download-linux' to fetch all sources needed for linux builds
|
||||||
|
|
||||||
|
|
|
@ -7,7 +7,7 @@ In theory, binaries for any target OS/architecture can be created, from a
|
||||||
builder running any OS/architecture. In practice, build-side tools must be
|
builder running any OS/architecture. In practice, build-side tools must be
|
||||||
specified when the defaults don't fit, and packages must be amended to work
|
specified when the defaults don't fit, and packages must be amended to work
|
||||||
on new hosts. For now, a build architecture of x86_64 is assumed, either on
|
on new hosts. For now, a build architecture of x86_64 is assumed, either on
|
||||||
Linux or OSX.
|
Linux or macOS.
|
||||||
|
|
||||||
### No reliance on timestamps
|
### No reliance on timestamps
|
||||||
|
|
||||||
|
|
|
@ -22,7 +22,7 @@ Unpack the files into a directory and run:
|
||||||
|
|
||||||
Unpack the files into a directory, and then run bitcoin-qt.exe.
|
Unpack the files into a directory, and then run bitcoin-qt.exe.
|
||||||
|
|
||||||
### OS X
|
### macOS
|
||||||
|
|
||||||
Drag Bitcoin-Core to your applications folder, and then run Bitcoin-Core.
|
Drag Bitcoin-Core to your applications folder, and then run Bitcoin-Core.
|
||||||
|
|
||||||
|
@ -38,7 +38,7 @@ Building
|
||||||
The following are developer notes on how to build Bitcoin on your native platform. They are not complete guides, but include notes on the necessary libraries, compile flags, etc.
|
The following are developer notes on how to build Bitcoin on your native platform. They are not complete guides, but include notes on the necessary libraries, compile flags, etc.
|
||||||
|
|
||||||
- [Dependencies](dependencies.md)
|
- [Dependencies](dependencies.md)
|
||||||
- [OS X Build Notes](build-osx.md)
|
- [macOS Build Notes](build-osx.md)
|
||||||
- [Unix Build Notes](build-unix.md)
|
- [Unix Build Notes](build-unix.md)
|
||||||
- [Windows Build Notes](build-windows.md)
|
- [Windows Build Notes](build-windows.md)
|
||||||
- [OpenBSD Build Notes](build-openbsd.md)
|
- [OpenBSD Build Notes](build-openbsd.md)
|
||||||
|
|
|
@ -1,12 +1,12 @@
|
||||||
Deterministic OS X DMG Notes.
|
Deterministic macOS DMG Notes.
|
||||||
|
|
||||||
Working OS X DMGs are created in Linux by combining a recent clang,
|
Working macOS DMGs are created in Linux by combining a recent clang,
|
||||||
the Apple binutils (ld, ar, etc) and DMG authoring tools.
|
the Apple binutils (ld, ar, etc) and DMG authoring tools.
|
||||||
|
|
||||||
Apple uses clang extensively for development and has upstreamed the necessary
|
Apple uses clang extensively for development and has upstreamed the necessary
|
||||||
functionality so that a vanilla clang can take advantage. It supports the use
|
functionality so that a vanilla clang can take advantage. It supports the use
|
||||||
of -F, -target, -mmacosx-version-min, and --sysroot, which are all necessary
|
of -F, -target, -mmacosx-version-min, and --sysroot, which are all necessary
|
||||||
when building for OS X.
|
when building for macOS.
|
||||||
|
|
||||||
Apple's version of binutils (called cctools) contains lots of functionality
|
Apple's version of binutils (called cctools) contains lots of functionality
|
||||||
missing in the FSF's binutils. In addition to extra linker options for
|
missing in the FSF's binutils. In addition to extra linker options for
|
||||||
|
@ -38,7 +38,7 @@ Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.1
|
||||||
Unfortunately, the usual linux tools (7zip, hpmount, loopback mount) are incapable of opening this file.
|
Unfortunately, the usual linux tools (7zip, hpmount, loopback mount) are incapable of opening this file.
|
||||||
To create a tarball suitable for Gitian input, there are two options:
|
To create a tarball suitable for Gitian input, there are two options:
|
||||||
|
|
||||||
Using Mac OS X, you can mount the dmg, and then create it with:
|
Using macOS, you can mount the dmg, and then create it with:
|
||||||
```
|
```
|
||||||
$ hdiutil attach Xcode_7.3.1.dmg
|
$ hdiutil attach Xcode_7.3.1.dmg
|
||||||
$ tar -C /Volumes/Xcode/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/ -czf MacOSX10.11.sdk.tar.gz MacOSX10.11.sdk
|
$ tar -C /Volumes/Xcode/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/ -czf MacOSX10.11.sdk.tar.gz MacOSX10.11.sdk
|
||||||
|
@ -81,7 +81,7 @@ Background images and other features can be added to DMG files by inserting a
|
||||||
.DS_Store before creation. This is generated by the script
|
.DS_Store before creation. This is generated by the script
|
||||||
contrib/macdeploy/custom_dsstore.py.
|
contrib/macdeploy/custom_dsstore.py.
|
||||||
|
|
||||||
As of OS X Mavericks (10.9), using an Apple-blessed key to sign binaries is a
|
As of OS X 10.9 Mavericks, using an Apple-blessed key to sign binaries is a
|
||||||
requirement in order to satisfy the new Gatekeeper requirements. Because this
|
requirement in order to satisfy the new Gatekeeper requirements. Because this
|
||||||
private key cannot be shared, we'll have to be a bit creative in order for the
|
private key cannot be shared, we'll have to be a bit creative in order for the
|
||||||
build process to remain somewhat deterministic. Here's how it works:
|
build process to remain somewhat deterministic. Here's how it works:
|
||||||
|
|
|
@ -1,11 +1,11 @@
|
||||||
Mac OS X Build Instructions and Notes
|
macOS Build Instructions and Notes
|
||||||
====================================
|
====================================
|
||||||
The commands in this guide should be executed in a Terminal application.
|
The commands in this guide should be executed in a Terminal application.
|
||||||
The built-in one is located in `/Applications/Utilities/Terminal.app`.
|
The built-in one is located in `/Applications/Utilities/Terminal.app`.
|
||||||
|
|
||||||
Preparation
|
Preparation
|
||||||
-----------
|
-----------
|
||||||
Install the OS X command line tools:
|
Install the macOS command line tools:
|
||||||
|
|
||||||
`xcode-select --install`
|
`xcode-select --install`
|
||||||
|
|
||||||
|
@ -93,6 +93,6 @@ Other commands:
|
||||||
Notes
|
Notes
|
||||||
-----
|
-----
|
||||||
|
|
||||||
* Tested on OS X 10.8 through 10.13 on 64-bit Intel processors only.
|
* Tested on OS X 10.8 Mountain Lion through macOS 10.13 High Sierra on 64-bit Intel processors only.
|
||||||
|
|
||||||
* Building with downloaded Qt binaries is not officially supported. See the notes in [#7714](https://github.com/bitcoin/bitcoin/issues/7714)
|
* Building with downloaded Qt binaries is not officially supported. See the notes in [#7714](https://github.com/bitcoin/bitcoin/issues/7714)
|
||||||
|
|
|
@ -15,7 +15,7 @@ Service User
|
||||||
|
|
||||||
All three Linux startup configurations assume the existence of a "bitcoin" user
|
All three Linux startup configurations assume the existence of a "bitcoin" user
|
||||||
and group. They must be created before attempting to use these scripts.
|
and group. They must be created before attempting to use these scripts.
|
||||||
The OS X configuration assumes bitcoind will be set up for the current user.
|
The macOS configuration assumes bitcoind will be set up for the current user.
|
||||||
|
|
||||||
Configuration
|
Configuration
|
||||||
---------------------------------
|
---------------------------------
|
||||||
|
@ -65,7 +65,7 @@ reasons to make the configuration file and data directory only readable by the
|
||||||
bitcoin user and group. Access to bitcoin-cli and other bitcoind rpc clients
|
bitcoin user and group. Access to bitcoin-cli and other bitcoind rpc clients
|
||||||
can then be controlled by group membership.
|
can then be controlled by group membership.
|
||||||
|
|
||||||
### Mac OS X
|
### macOS
|
||||||
|
|
||||||
Binary: `/usr/local/bin/bitcoind`
|
Binary: `/usr/local/bin/bitcoind`
|
||||||
Configuration file: `~/Library/Application Support/Bitcoin/bitcoin.conf`
|
Configuration file: `~/Library/Application Support/Bitcoin/bitcoin.conf`
|
||||||
|
@ -111,7 +111,7 @@ Using this script, you can adjust the path and flags to the bitcoind program by
|
||||||
setting the BITCOIND and FLAGS environment variables in the file
|
setting the BITCOIND and FLAGS environment variables in the file
|
||||||
/etc/sysconfig/bitcoind. You can also use the DAEMONOPTS environment variable here.
|
/etc/sysconfig/bitcoind. You can also use the DAEMONOPTS environment variable here.
|
||||||
|
|
||||||
### Mac OS X
|
### macOS
|
||||||
|
|
||||||
Copy org.bitcoin.bitcoind.plist into ~/Library/LaunchAgents. Load the launch agent by
|
Copy org.bitcoin.bitcoind.plist into ~/Library/LaunchAgents. Load the launch agent by
|
||||||
running `launchctl load ~/Library/LaunchAgents/org.bitcoin.bitcoind.plist`.
|
running `launchctl load ~/Library/LaunchAgents/org.bitcoin.bitcoind.plist`.
|
||||||
|
|
|
@ -89,7 +89,7 @@ Ensure gitian-builder is up-to-date:
|
||||||
wget -P inputs http://downloads.sourceforge.net/project/osslsigncode/osslsigncode/osslsigncode-1.7.1.tar.gz
|
wget -P inputs http://downloads.sourceforge.net/project/osslsigncode/osslsigncode/osslsigncode-1.7.1.tar.gz
|
||||||
popd
|
popd
|
||||||
|
|
||||||
Create the OS X SDK tarball, see the [OS X readme](README_osx.md) for details, and copy it into the inputs directory.
|
Create the macOS SDK tarball, see the [macOS readme](README_osx.md) for details, and copy it into the inputs directory.
|
||||||
|
|
||||||
### Optional: Seed the Gitian sources cache and offline git repositories
|
### Optional: Seed the Gitian sources cache and offline git repositories
|
||||||
|
|
||||||
|
@ -111,7 +111,7 @@ NOTE: Offline builds must use the --url flag to ensure Gitian fetches only from
|
||||||
|
|
||||||
The gbuild invocations below <b>DO NOT DO THIS</b> by default.
|
The gbuild invocations below <b>DO NOT DO THIS</b> by default.
|
||||||
|
|
||||||
### Build and sign Bitcoin Core for Linux, Windows, and OS X:
|
### Build and sign Bitcoin Core for Linux, Windows, and macOS:
|
||||||
|
|
||||||
pushd ./gitian-builder
|
pushd ./gitian-builder
|
||||||
./bin/gbuild --num-make 2 --memory 3000 --commit bitcoin=v${VERSION} ../bitcoin/contrib/gitian-descriptors/gitian-linux.yml
|
./bin/gbuild --num-make 2 --memory 3000 --commit bitcoin=v${VERSION} ../bitcoin/contrib/gitian-descriptors/gitian-linux.yml
|
||||||
|
@ -134,7 +134,7 @@ Build output expected:
|
||||||
1. source tarball (`bitcoin-${VERSION}.tar.gz`)
|
1. source tarball (`bitcoin-${VERSION}.tar.gz`)
|
||||||
2. linux 32-bit and 64-bit dist tarballs (`bitcoin-${VERSION}-linux[32|64].tar.gz`)
|
2. linux 32-bit and 64-bit dist tarballs (`bitcoin-${VERSION}-linux[32|64].tar.gz`)
|
||||||
3. windows 32-bit and 64-bit unsigned installers and dist zips (`bitcoin-${VERSION}-win[32|64]-setup-unsigned.exe`, `bitcoin-${VERSION}-win[32|64].zip`)
|
3. windows 32-bit and 64-bit unsigned installers and dist zips (`bitcoin-${VERSION}-win[32|64]-setup-unsigned.exe`, `bitcoin-${VERSION}-win[32|64].zip`)
|
||||||
4. OS X unsigned installer and dist tarball (`bitcoin-${VERSION}-osx-unsigned.dmg`, `bitcoin-${VERSION}-osx64.tar.gz`)
|
4. macOS unsigned installer and dist tarball (`bitcoin-${VERSION}-osx-unsigned.dmg`, `bitcoin-${VERSION}-osx64.tar.gz`)
|
||||||
5. Gitian signatures (in `gitian.sigs/${VERSION}-<linux|{win,osx}-unsigned>/(your Gitian key)/`)
|
5. Gitian signatures (in `gitian.sigs/${VERSION}-<linux|{win,osx}-unsigned>/(your Gitian key)/`)
|
||||||
|
|
||||||
### Verify other gitian builders signatures to your own. (Optional)
|
### Verify other gitian builders signatures to your own. (Optional)
|
||||||
|
@ -161,13 +161,13 @@ Commit your signature to gitian.sigs:
|
||||||
git push # Assuming you can push to the gitian.sigs tree
|
git push # Assuming you can push to the gitian.sigs tree
|
||||||
popd
|
popd
|
||||||
|
|
||||||
Codesigner only: Create Windows/OS X detached signatures:
|
Codesigner only: Create Windows/macOS detached signatures:
|
||||||
- Only one person handles codesigning. Everyone else should skip to the next step.
|
- Only one person handles codesigning. Everyone else should skip to the next step.
|
||||||
- Only once the Windows/OS X builds each have 3 matching signatures may they be signed with their respective release keys.
|
- Only once the Windows/macOS builds each have 3 matching signatures may they be signed with their respective release keys.
|
||||||
|
|
||||||
Codesigner only: Sign the osx binary:
|
Codesigner only: Sign the macOS binary:
|
||||||
|
|
||||||
transfer bitcoin-osx-unsigned.tar.gz to osx for signing
|
transfer bitcoin-osx-unsigned.tar.gz to macOS for signing
|
||||||
tar xf bitcoin-osx-unsigned.tar.gz
|
tar xf bitcoin-osx-unsigned.tar.gz
|
||||||
./detached-sig-create.sh -s "Key ID"
|
./detached-sig-create.sh -s "Key ID"
|
||||||
Enter the keychain password and authorize the signature
|
Enter the keychain password and authorize the signature
|
||||||
|
@ -192,12 +192,12 @@ Codesigner only: Commit the detached codesign payloads:
|
||||||
git tag -s v${VERSION} HEAD
|
git tag -s v${VERSION} HEAD
|
||||||
git push the current branch and new tag
|
git push the current branch and new tag
|
||||||
|
|
||||||
Non-codesigners: wait for Windows/OS X detached signatures:
|
Non-codesigners: wait for Windows/macOS detached signatures:
|
||||||
|
|
||||||
- Once the Windows/OS X builds each have 3 matching signatures, they will be signed with their respective release keys.
|
- Once the Windows/macOS builds each have 3 matching signatures, they will be signed with their respective release keys.
|
||||||
- Detached signatures will then be committed to the [bitcoin-detached-sigs](https://github.com/bitcoin-core/bitcoin-detached-sigs) repository, which can be combined with the unsigned apps to create signed binaries.
|
- Detached signatures will then be committed to the [bitcoin-detached-sigs](https://github.com/bitcoin-core/bitcoin-detached-sigs) repository, which can be combined with the unsigned apps to create signed binaries.
|
||||||
|
|
||||||
Create (and optionally verify) the signed OS X binary:
|
Create (and optionally verify) the signed macOS binary:
|
||||||
|
|
||||||
pushd ./gitian-builder
|
pushd ./gitian-builder
|
||||||
./bin/gbuild -i --commit signature=v${VERSION} ../bitcoin/contrib/gitian-descriptors/gitian-osx-signer.yml
|
./bin/gbuild -i --commit signature=v${VERSION} ../bitcoin/contrib/gitian-descriptors/gitian-osx-signer.yml
|
||||||
|
@ -216,7 +216,7 @@ Create (and optionally verify) the signed Windows binaries:
|
||||||
mv build/out/bitcoin-*win32-setup.exe ../bitcoin-${VERSION}-win32-setup.exe
|
mv build/out/bitcoin-*win32-setup.exe ../bitcoin-${VERSION}-win32-setup.exe
|
||||||
popd
|
popd
|
||||||
|
|
||||||
Commit your signature for the signed OS X/Windows binaries:
|
Commit your signature for the signed macOS/Windows binaries:
|
||||||
|
|
||||||
pushd gitian.sigs
|
pushd gitian.sigs
|
||||||
git add ${VERSION}-osx-signed/"${SIGNER}"
|
git add ${VERSION}-osx-signed/"${SIGNER}"
|
||||||
|
|
|
@ -4,7 +4,7 @@ The current precise version for Qt 5 is specified in [qt.mk](/depends/packages/q
|
||||||
|
|
||||||
## Compile and run
|
## Compile and run
|
||||||
|
|
||||||
See build instructions ([OSX](/doc/build-osx.md), [Windows](/doc/build-windows.md), [Unix](/doc/build-unix.md), etc).
|
See build instructions ([macOS](/doc/build-osx.md), [Windows](/doc/build-windows.md), [Unix](/doc/build-unix.md), etc).
|
||||||
|
|
||||||
To run:
|
To run:
|
||||||
|
|
||||||
|
@ -65,7 +65,7 @@ Represents the view to a single wallet.
|
||||||
* `guiconstants.h`: UI colors, app name, etc
|
* `guiconstants.h`: UI colors, app name, etc
|
||||||
* `guiutil.h`: several helper functions
|
* `guiutil.h`: several helper functions
|
||||||
* `macdockiconhandler.(h/cpp)`
|
* `macdockiconhandler.(h/cpp)`
|
||||||
* `macdockiconhandler.(h/cpp)`: display notifications in OSX
|
* `macdockiconhandler.(h/cpp)`: display notifications in macOS
|
||||||
|
|
||||||
## Contribute
|
## Contribute
|
||||||
|
|
||||||
|
@ -81,9 +81,9 @@ the UI layout.
|
||||||
Download and install the community edition of [Qt Creator](https://www.qt.io/download/).
|
Download and install the community edition of [Qt Creator](https://www.qt.io/download/).
|
||||||
Uncheck everything except Qt Creator during the installation process.
|
Uncheck everything except Qt Creator during the installation process.
|
||||||
|
|
||||||
Instructions for OSX:
|
Instructions for macOS:
|
||||||
|
|
||||||
1. Make sure you installed everything through Homebrew mentioned in the [OSX build instructions](/doc/build-osx.md)
|
1. Make sure you installed everything through Homebrew mentioned in the [macOS build instructions](/doc/build-osx.md)
|
||||||
2. Use `./configure` with the `--enable-debug` flag
|
2. Use `./configure` with the `--enable-debug` flag
|
||||||
3. In Qt Creator do "New Project" -> Import Project -> Import Existing Project
|
3. In Qt Creator do "New Project" -> Import Project -> Import Existing Project
|
||||||
4. Enter "bitcoin-qt" as project name, enter src/qt as location
|
4. Enter "bitcoin-qt" as project name, enter src/qt as location
|
||||||
|
|
Loading…
Reference in a new issue