Skip to content

Latest commit

 

History

History
105 lines (65 loc) · 2.28 KB

building.md

File metadata and controls

105 lines (65 loc) · 2.28 KB
Raw

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:

Required tools for VS 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:

Developer Command Prompt for VS 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: If Unicorn can't find Python, use make UNICORN_QEMU_FLAGS="--python=/usr/bin/python2" or similar to point it to your installation. make works after you do this once.

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