docs: Adding build guide for macOS

This commit is contained in:
sr55 2016-09-10 16:20:30 +01:00
parent 78c07e13ae
commit be1cd6b149
2 changed files with 74 additions and 0 deletions

View File

@ -0,0 +1,73 @@
---
Type: article
State: draft
Title: Building HandBrake for macOS
Project: HandBrake
Project_URL: https://handbrake.fr/
Project_Version: Latest
Language: English
Language_Code: en
Text_Encoding: utf-8
Authors: Scott (s55)
Copyright: 2016 HandBrake Team
License: Creative Commons Attribution-ShareAlike 4.0 International
License_Abbr: CC BY-SA 4.0
License_URL: https://handbrake.fr/docs/license.html
---
Building HandBrake for macOS
==========================================
## Be prepared
The first step is to get your development environment right.
* [Download and install the Xcode Developer Tools](http://developer.apple.com/mac/) (you will need to register with Apple, but it's free)
* Download, compile, and install a current version of yasm:
Open up the Terminal. That's found in your /Applications/Utilities folder.
In the window that appears, type the following:
curl http://www.tortall.net/projects/yasm/releases/yasm-1.3.0.tar.gz> yasm-1.3.0.tar.gz
tar -xvf yasm-1.3.0.tar.gz
cd yasm-1.3.0/
./configure ; make
When that finishes, you'll need to install yasm. Type the following:
sudo make install
*(You'll need to enter your system password at this point and hit return)*
Once yasm is installed, clean up by typing:
cd ../
rm -rf yasm-1.2.0 yasm-1.2.0.tar.gz
*Leave that Terminal window open for the next step.*
## Meet your maker
In the Terminal window, type:
git clone https://github.com/HandBrake/HandBrake.git handbrake-git
cd handbrake-git/
./configure --launch --launch-jobs=0 ; open build/
This will take awhile. When it's done, you'll see a window in front of you with your freshly-built copies of !HandBrake and HandBrakeCLI.
## Reach enlightenment
This is just a simple quick-start guide. For the real meat and potatoes, [see the latest OS X build documentation](https://github.com/HandBrake/HandBrake/blob/master/doc/BUILD-Mac). Topics covered there include:
* Running configuration and build commands on subsequent compiles (hint, do it from the build/ directory, not the root)
* Cleaning build files
* Tweaking contrib libraries

View File

@ -149,4 +149,5 @@ Table of contents
- [Linux Flatpaks](developer/flatpak-repo.html)
- Building HandBrake
- [Building on Windows](developer/build-windows.html)
- [Building on macOS](developer/build-mac.html)