AnyPS5/docs/dev/BUILD.md

Build

git submodule update --init --recursive

Requirements

• x86-64, Git, CMake 3.22.1 or newer, Ninja, C++20.
• Linux: GCC, G++, binutils.
• Windows: only MinGW-w64 GCC 15.2.0 (WinLibs x86_64-ucrt-posix-seh, release 15.2.0posix-14.0.0-ucrt-r7) is currently supported. Add its mingw64/bin directory to PATH before configuring.
• FFmpeg binaries are downloaded during configuration unless FFMPEG_PREBUILT_DIR is set.

Commands

cmake -S . -B build -G Ninja -DCMAKE_BUILD_TYPE=Release -DCMAKE_C_COMPILER=gcc -DCMAKE_CXX_COMPILER=g++
cmake --build build --parallel
cmake --build build --target libs --parallel

Relinker usage and runtime layout.

CMake flags

Project switches accept ON or OFF:

Flag	Default	Effect
-DBUILD_TESTING=ON	OFF	Build and register tests.
-DANYPS5_ENABLE_SPIRV_TOOLS=ON	OFF	Enable SPIR-V validation and optimization.
-DAPS5_ENABLE_TIMING_LOG=ON	OFF	Compile frame timing logging.
-DAPS5_AGC_CREATE_LOG=OFF	ON	Disable successful sceAgcCreateShader logging.
-DAGC_BUILD_VISUAL_TEST=ON	OFF	Build the standalone AGC SPIR-V visual test.

Build configuration parameters:

Flag	Value
-DCMAKE_BUILD_TYPE=Release	Debug, Release, RelWithDebInfo, or MinSizeRel.
-DCMAKE_C_COMPILER=gcc	C compiler name or absolute path.
-DCMAKE_CXX_COMPILER=g++	C++ compiler name or absolute path.
-DCMAKE_C_COMPILER_LAUNCHER=ccache	Optional C compiler cache; requires ccache.
-DCMAKE_CXX_COMPILER_LAUNCHER=ccache	Optional C++ compiler cache; requires ccache.
-DFFMPEG_PREBUILT_DIR=<path>	Unpacked FFmpeg package for the target platform; empty by default.

SDL and FreeType settings forced by the root CMakeLists.txt cannot be overridden with -D.

Shader recompiler

The shader recompilation logic in core/shader/recompiler is isolated from the rest of the project and is a pure function of its input data, designed for integration into any other project. The current CMake target also includes cache support and links a supplied runtime target, glslang, and optionally SPIRV-Tools.