macOS

Build High Fidelity in macOS.

Overview

Please read the general build guide for information on dependencies required for all platforms. Only macOS specific instructions are found in this file.

Homebrew

Homebrew is an excellent package manager for macOS. It makes install of some High Fidelity dependencies very simple.

brew tap homebrew/versions
brew install cmake openssl qt

OpenSSL

Assuming you've installed OpenSSL using the homebrew instructions above, you'll need to set OPENSSL_ROOT_DIR so CMake can find your installations. For OpenSSL installed via homebrew, set OPENSSL_ROOT_DIR:

export OPENSSL_ROOT_DIR=/usr/local/Cellar/openssl/1.0.2h

This uses the version from the homebrew formula at the time of this writing, and the version in the path will likely change.

Qt

Assuming you've installed Qt using the homebrew instructions above, you'll need to set QT_CMAKE_PREFIX_PATH so CMake can find your installations. For Qt installed via homebrew, set QT_CMAKE_PREFIX_PATH:

export QT_CMAKE_PREFIX_PATH=/usr/local/Cellar/qt/5.9.1/lib/cmake

that this uses the version from the homebrew formula at the time of this writing, and the version in the path will likely change.

Xcode

If Xcode is your editor of choice, you can ask CMake to generate Xcode project files instead of Unix Makefiles.

cmake .. -GXcode

After running cmake, you will have the make files or Xcode project file necessary to build all of the components. Open the hifi.xcodeproj file, choose ALL_BUILD from the Product > Scheme menu (or target drop down), and click Run.

If the build completes successfully, you will have built targets for all components located in the build/${target_name}/Debugdirectories.