Vita3K/building.md

Build Vita3K

Windows (Visual Studio)

• Install Visual Studio 2017 or 2019 and choose to install Desktop development with C++. You will get compiler and cmake required for building.

Example for Visual Studio 2019:

• Install git to clone the project. Download and install git from here.

• Clone this repo.

git clone --recursive https://github.com/Vita3K/Vita3K
cd Vita3K

• Open Developer Command Prompt for your respective Visual Studio version. cmake and other C/C++ toolchain only available on Developer Command Prompt.

Example for Visual Studio 2019:

• Run gen-windows.bat to create Visual Studio project in build-windows directory.

.\gen-windows

• Open the project generated in the build-windows directory.

• Build and run it.

macOS (Xcode)

• Install Xcode at App Store.

• Install brew.

• Install dependencies with brew.

brew install git cmake

• Clone this repo.

git clone --recursive https://github.com/Vita3K/Vita3K
cd Vita3K

• Generate Xcode project.

./gen-macos.sh

• Open Xcode project vita3k.xcodeproj generated in build-macos directory.

• When prompted to create schemes, create one for the vita3k target only. The project builds many targets, so it will make your life easier if you create schemes as needed.

• Build.

Linux

Ubuntu/Debian

• Install dependencies.

sudo apt install git cmake libsdl2-dev pkg-config libgtk-3-dev

• Clone this repo.

git clone --recursive https://github.com/Vita3K/Vita3K
cd Vita3K

• Build the project.

./gen-linux.sh
cd build-linux
make -j$(nproc)

Note

• After cloning or checking out a branch, you should always update submodules.

git submodule update --init --recursive

• If boost failed to build, you can opt out for system boost package (Linux and macOS only).

brew install boost # for macOS
sudo apt install libboost-all-dev # for Ubuntu/Debian