450 | | * Obtain the command line tools: |
451 | | * If you're using Lion 10.7.3 or later, Apple has made their ''Command Line Tools for Xcode'' package freely available, as a separate download. '''It does not include or require Xcode.''' If you don't want the Xcode IDE, it's recommended to install only this package from [https://developer.apple.com/downloads/index.action Apple Developer Downloads]. You need a free Apple ID to access the download. If you already have Xcode 5.1+, you can download the command line tools from the [https://developer.apple.com/library/IOs/#recipes/xcode_help-documentation_preferences/DownloadingandInstallingXcodeComponents/DownloadingandInstallingXcodeComponents.html download preferences]. |
452 | | * If you're using Lion 10.7.2 or earlier, you'll probably need to install Xcode to get the command line tools: |
453 | | * If available, use your Mac macOS install DVD which saves downloading 1.72+ GB. |
454 | | * Visit [https://developer.apple.com/downloads/index.action Apple Developer Downloads] (logging in with your free Apple ID) and download the latest Xcode version for your OS. |
455 | | * The latest version of Xcode is also available for free from the [http://www.apple.com/mac/app-store/ Mac App Store]. ''Note: if you download the app, it is only the installer for Xcode. You need to open it and run the "Install Xcode" app.'' |
456 | | * If you want to build a distributable app bundle as described below, you will need Xcode. |
457 | | * '''Note:''' As of Mavericks (10.9) and Xcode 5, Apple [https://developer.apple.com/library/mac/releasenotes/DeveloperTools/RN-Xcode/xc5_release_notes/xc5_release_notes.html#//apple_ref/doc/uid/TP40001051-CH2-SW302 no longer supports] llvm-gcc, instead it is required to use clang. Additionally, the default C++ library is now libc++ instead of libstdc++. If you've upgraded and previously built the game, you should pass the `--force-rebuild` flag to `build-osx-libs.sh`. |
458 | | * As of Alpha 21, the game uses SpiderMonkey 45 which requires a Python 2.7 version later than 2.7.3. If you're on Mountain Lion (10.8) or earlier, you will need to first update your Python installation with the latest 2.7.x installer from [https://www.python.org/downloads/release/python-279/ here]. |
459 | | * Obtain CMake: |
460 | | * You can download a prebuilt macOS package [https://cmake.org/download/ here]. |
461 | | * If prompted, install the CMake command line tools to the default location. |
462 | | * '''Note:''' Recent versions have no installer, so after copying the app bundle to '''Applications''', you need to run CMake with elevated permissions to install the command line tools. From the terminal: |
463 | | {{{ |
464 | | #!sh |
465 | | sudo "/Applications/CMake.app/Contents/bin/cmake-gui" --install |
466 | | }}} |
467 | | * If the install command fails, you can manually add the following line to the end of `/etc/paths`: |
468 | | {{{ |
469 | | /Applications/CMake.app/Contents/bin |
470 | | }}} |
| 450 | 1. '''Apple Command Line Tools for Xcode'''. There are a number of command-line tools you need that are not installed on macOS by default. Instead, these are available as a separate free download from Apple. '''This does not include or require Xcode.''' It is branded as "for Xcode" but it works by itself. |
| 451 | * If you're using macOS 10.7 Lion or later, install this package from [https://developer.apple.com/downloads/index.action Apple Developer Downloads]. You need a (free) Apple ID to access the download. |
| 452 | * See [https://developer.apple.com/library/archive/technotes/tn2339/_index.html Apple Command Line FAQ] for additional instructions. |
| 453 | 2. Python 2.7.3 or later If you're on Mountain Lion (10.8) or earlier, you will need to first update your Python installation with the latest 2.7.x installer from [https://www.python.org/downloads/release/python-279/ here]. |
| 454 | 3. CMake: |
| 455 | * If you have [https://brew.sh/ Homebrew] installed, use [https://brewformulas.org/Cmake `brew install cmake`]. |
| 456 | * Alternatively, download a prebuilt macOS package at https://cmake.org/download/. If prompted, choose to install the "CMake command line tools" to the **default location**. |
| 457 | * '''Note:''' Recent versions have no installer, so after copying the app bundle to '''Applications''', you need to run CMake with elevated permissions to install the command line tools. From the terminal: `sudo "/Applications/CMake.app/Contents/bin/cmake-gui" --install`. |
| 458 | * If the install command fails, you can manually add the following line to the end of `/etc/paths`: `/Applications/CMake.app/Contents/bin`. |