HandBrake/HandBrake-docs
1
0
Fork 0
mirror of https://github.com/HandBrake/HandBrake-docs.git synced 2025-12-10 00:44:52 -06:00
Code Issues Packages Projects Releases 1 Wiki Activity

docs: update macOS build instructions.

Browse Source
This commit is contained in:
Damiano Galassi 2023-12-24 08:54:18 +01:00
parent dfb100e855
commit cd1b7abe8a
No known key found for this signature in database
GPG Key ID: 5452E231DFDBCA11
1 changed files with 21 additions and 28 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

49
source/docs/en/latest/developer/build-mac.markdown
View File

@ -16,35 +16,34 @@ License_URL: https://handbrake.fr/docs/license.html
Building HandBrake for Mac Building HandBrake for Mac
========================== ==========================
Building HandBrake for Mac requires an Apple computer with a 64-bit Intel processor running macOS 10.14.3 Mojave or later, and the following dependencies. Building HandBrake for Mac requires an Apple computer with a 64-bit Intel processor running macOS 12.6.7 Monterey or later, and the following dependencies.
- [Xcode](https://developer.apple.com/xcode/) 10.3 or later - [Xcode](https://developer.apple.com/xcode/) 14.3.1 or later
- free Apple Developer registration required, or install from the Mac App Store - free Apple Developer registration required, or install from the Mac App Store
- [Command Line Tools for Xcode](https://developer.apple.com/download/more/)
- free Apple Developer registration required, or install using `xcode-select --install`
- [Python](https://www.python.org/downloads/) 3.7.0 or later
Python 3 as included with macOS 11.0 Big Sur is sufficient. For macOS prior to Big Sur, after installing an updated Python 3 from an official source, please ensure the installation has properly created `/Library/Frameworks/Python.framework/Versions/<version>`.
Additional dependencies (may be built via included script): Additional dependencies (may be built via included script):
- autoconf 2.69 or later - autoconf 2.71 or later
- automake 1.13 or later - automake 1.16.5 or later
- cmake 3.1.0 or later - cmake 3.27.4 or later
- libtool 2.4.6 or later - libtool 2.4.7 or later
- meson 0.47.0 or later - meson 1.2.1 or later
- nasm 2.13 or later - nasm 2.15.05 or later
- ninja 1.8.0 or later - ninja 1.11.1 or later
- pkg-config 0.27.0 or later - pkg-config 0.29.2 or later
Optional dependencies (required by libdovi)
- [Rust](https://www.rust-lang.org/tools/install) 1.64.0 or later
- Cross-compiling requires the ana dditional target:
- `rustup target add aarch64-apple-darwin` for cross-compiling for Apple Silicon on an Intel Mac
- `rustup target add x86_64-apple-darwin` for cross-compiling for Intel on Apple Silicon
- [openssl](https://www.openssl.org)
- [cargo-c](https://github.com/lu-zero/cargo-c)
- Can be installed by running `cargo install cargo-c`
Install Xcode and open it once. Approve any prompts to install additional tools. You may quit Xcode after it has finished loading. Install Xcode and open it once. Approve any prompts to install additional tools. You may quit Xcode after it has finished loading.
Install Command Line Tools for Xcode using the package installer provided by Apple[^xcode-cli-tools], or using `xcode-select`.
xcode-select --install
For macOS prior to Big Sur, install Python 3 using the latest package installer provided by [Python](https://www.python.org/downloads/).
If you installed Python 3 from a different source, such as Homebrew, it is necessary to check whether Python 3 can properly open HTTPS connections. The following test prints `0` for success, or `1` for failure. Upon failure, you will need to ensure SSL certificates are installed and accessible to your Python 3 installation, or remove the installation and reinstall from the official package. If you installed Python 3 from a different source, such as Homebrew, it is necessary to check whether Python 3 can properly open HTTPS connections. The following test prints `0` for success, or `1` for failure. Upon failure, you will need to ensure SSL certificates are installed and accessible to your Python 3 installation, or remove the installation and reinstall from the official package.
python3 -c 'from urllib.request import urlopen; test = lambda x=exec("def f():\n try:\n urlopen(\"https://handbrake.fr\", timeout=10)\n return 0\n except: return 1"): f(); result = test(); exit(result)'; echo $? python3 -c 'from urllib.request import urlopen; test = lambda x=exec("def f():\n try:\n urlopen(\"https://handbrake.fr\", timeout=10)\n return 0\n except: return 1"): f(); result = test(); exit(result)'; echo $?
@ -53,13 +52,9 @@ Clone the HandBrake repository.
git clone https://github.com/HandBrake/HandBrake.git && cd HandBrake git clone https://github.com/HandBrake/HandBrake.git && cd HandBrake
Initialize and update all submodules.
git submodule update --init --recursive
You may build and install the additional dependencies using the included script. Feel free to choose a different output path, if desired. You may build and install the additional dependencies using the included script. Feel free to choose a different output path, if desired.
scripts/mac-toolchain-build /usr/local sudo scripts/mac-toolchain-build /usr/local
This process will take a few minutes. If necessary, the script will provide you with instructions for adding the resulting binaries location to your environment's `PATH`[^default-path]. Do this now. This process will take a few minutes. If necessary, the script will provide you with instructions for adding the resulting binaries location to your environment's `PATH`[^default-path]. Do this now.
@ -77,6 +72,4 @@ To start over, simply remove the `build` directory.
rm -rf build rm -rf build
[^xcode-cli-tools]: When installing Command Line Tools for Xcode using the package installer (instead of `xcode-select --install`), make sure to install the package that corresponds to the installed Xcode version. A mismatch between the installed Xcode and Command Line Tools versions may cause problems.
[^default-path]: `/usr/local/bin` is included in the system's `PATH` by default. It is not necessary to add it to your environment's `PATH` when installing the additional dependencies to `/usr/local`. [^default-path]: `/usr/local/bin` is included in the system's `PATH` by default. It is not necessary to add it to your environment's `PATH` when installing the additional dependencies to `/usr/local`.