yuzu-wiki/Building-for-macOS.md

53 lines
1.6 KiB
Markdown
Raw Normal View History

2018-01-18 17:14:37 +00:00
### Dependencies
2018-01-14 06:14:58 +00:00
2018-01-18 17:14:37 +00:00
It's recommended that you use [Homebrew](http://brew.sh/) to install dependencies.
2018-01-14 06:14:58 +00:00
You'll need to download and install the following to build yuzu:
* [pkg-config](https://www.freedesktop.org/wiki/Software/pkg-config/) (`brew install pkgconfig`)
2018-01-14 11:27:24 +00:00
* [SDL2](https://www.libsdl.org/download-2.0.php) (`brew install sdl2`)
2018-01-14 06:14:58 +00:00
* [Qt5](https://www.qt.io/download/) (`brew install qt5`) (**Note:** If you have Qt4 installed, then you will need to remove it before building. `brew unlink qt4`)
* [CMake](https://cmake.org/) (`brew install cmake`)
* A recent version of Xcode and the Xcode command line tools
2018-01-18 17:14:37 +00:00
### Cloning yuzu with Git
2018-01-14 06:14:58 +00:00
2018-01-18 17:14:37 +00:00
```bash
2018-01-14 06:14:58 +00:00
git clone --recursive https://github.com/yuzu-emu/yuzu
cd yuzu
git submodule update --init --recursive
```
2018-01-18 17:14:37 +00:00
### Using CMake
2018-01-14 06:14:58 +00:00
2018-01-18 17:14:37 +00:00
First of all, you have to tell CMake where Qt5 is installed (add this line to ~/.profile if you want to make this permanent):
2018-01-14 06:14:58 +00:00
2018-01-18 17:14:37 +00:00
```bash
2018-01-14 06:14:58 +00:00
export Qt5_DIR=$(brew --prefix)/opt/qt5
```
Now you can generate makefiles for the build:
2018-01-18 17:14:37 +00:00
```bash
2018-01-14 06:14:58 +00:00
export MACOSX_DEPLOYMENT_TARGET=10.9
mkdir build
cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
2018-01-14 06:14:58 +00:00
```
### Building yuzu
2018-01-18 17:14:37 +00:00
```bash
2018-01-14 06:14:58 +00:00
make -j4
```
2018-01-14 16:56:51 +00:00
Temporary unicorn fixup:
2018-01-18 17:14:37 +00:00
```bash
# copy libunicorn.1.dylib into yuzu.app/Contents/MacOS
2018-01-14 16:56:51 +00:00
# then run:
install_name_tool -change libunicorn.1.dylib @executable_path/libunicorn.1.dylib yuzu.app/Contents/MacOS/yuzu
```
2018-01-14 06:14:58 +00:00
A `yuzu_qt.app` application bundle will now be present under `build/src/yuzu_qt/`. Note that this is non-portable and only works on your machine.
For portability of the appbundle between machines please refer to [this script](https://github.com/yuzu-emu/yuzu/blob/master/.travis/macos/upload.sh).