Cemu/BUILD.md
2022-08-25 14:16:14 -03:00

44 lines
1.9 KiB
Markdown

# Build instructions
## Windows
Prerequisites:
- A recent version of Visual Studio 2022 with CMake tools component
- git
- Vulkan SDK ([https://vulkan.lunarg.com/](https://vulkan.lunarg.com/)). Don't forget to restart after installing.
Instructions:
1) Run `git clone --recursive https://github.com/cemu-project/Cemu`
2) Launch `Cemu/generate_vs_solution.bat`. If you installed VS to a custom location you may need to manually adjust the path inside the bat file
3) Wait until done, then open `Cemu/build/Cemu.sln` in Visual Studio
4) Right click 'CemuBin' project -> Set as startup project
5) Then build the solution and once finished you can run and debug it
You can also skip steps 3-5 and open the root folder of the cloned repo directly in Visual Studio (as a folder) and use the inbuilt cmake support, but be warned that cmake support in VS can be a bit finicky.
## Linux
To compile Cemu, a recent enough compiler and STL with C++20 support is required! We use clang 12, other compilers may work as well.
For ubuntu and most derivatives:
`sudo apt install -y libgtk-3-dev libsecret-1-dev libgcrypt20-dev libsystemd-dev freeglut3-dev clang-12 nasm curl zip unzip tar git cmake ninja-build`
For Arch and most derivatives:
`sudo pacman -S --needed gtk3 libsecret libgcrypt systemd-libs freeglut nasm git`
For Fedora and most derivatives:
`sudo dnf in -y gtk3-devel libsecret-devel libgcrypt-devel systemd-devel freeglut-devel nasm cmake vcpkg perl-core zlib-devel`
1) Make sure vulkansdk is installed and the VULKAN_SDK environment variable is set correctly.
2) Run `git clone --recursive https://github.com/cemu-project/Cemu`
3) `cd Cemu`
4) `mkdir build && cd build`
5) `cmake .. -DPUBLIC_RELEASE=ON -DCMAKE_C_COMPILER=/usr/bin/clang -DCMAKE_CXX_COMPILER=/usr/bin/clang++ -G Ninja -DCMAKE_BUILD_WITH_INSTALL_RPATH=ON -DCMAKE_MAKE_PROGRAM=/usr/bin/ninja`
6) `ninja`
Build instructions for other distributions will be added in the future!