Skip to content
Gluten edited this page Jan 6, 2015 · 10 revisions

Dependencies:

It's recommended that you use homebrew to install dependencies. You'll need to download and install the following to build Citra:

  • pkg-config (brew install pkgconfig)
  • GLFW (brew tap homebrew/versions, brew install glfw3)
  • Qt5 (brew install qt5)
  • CMake (brew install cmake)

Building GLFW from source:

Should you choose not to use homebrew, type these commands in a terminal:

git clone https://github.com/glfw/glfw.git
cd glfw
mkdir build && cd build
cmake ..
make
sudo make install

Cloning Citra in Git:

git clone --recursive https://github.com/citra-emu/citra
cd citra

Using CMake:

First of all, you have to tell CMake where your Qt5 is installed (add this line to ~/.profile if you want to make this permanent.):

export CMAKE_PREFIX_PATH=/path/to/Qt5/5.X/clang_64/lib/cmake:$CMAKE_PREFIX_PATH

In the case that you installed Qt5 with Homebrew, this path is probably something like /usr/local/Cellar/qt5/<specific version here>/lib/cmake.

mkdir build
cd build
cmake .. -GXcode

Optionally, you can use cmake -i .. -GXcode or ccmake .. -GXcode to adjust various options (e.g. disable Qt GUI).

Building with debug symbols:

cmake .. -GXcode -DCMAKE_BUILD_TYPE=Debug

Building Citra:

Open the project file in Xcode, switch the target from ALL_BUILD to citra or citra_qt, and press the play button. The project can also be built via:

xcodebuild -config Release -project citra.xcodeproj -target citra-qt