Build Instructions for Linux

Note

This page applies to the in-development new build system. For current build instructions, see here.

Prerequisites

• Git
• CMake 3.28 or higher
• A compiler toolchain such as clang or gcc

ares requires development versions of the following packages in order to build:

• X11
• libGL
• GTK3 (gtk+-3.0)

Recommended development packages include:

• librashader
• SDL2

You may also configure with development packages for other audio drivers:

• OpenAL
• AO
• ALSA
• PulseAudio

Optional but recommended build tools include:

• Ninja
• clang
• Ccache

Configuration

First, clone the ares repository:

git clone https://github.com/ares-emulator/ares
cd ares

Building ares with clang and Ninja is recommended:

mkdir build && cd build
cmake .. -DCMAKE_C_COMPILER=clang -DCMAKE_CXX_COMPILER=clang++ -G "Ninja Multi-Config"

The generation step will report what features are enabled and disabled according to the libraries found on your system. Next, build ares:

cmake --build .

After building, products can be found in the rundir folder. ares can be run from this location, or the rundir can be relocated. ares can also be installed:

cmake --install . --prefix <your install prefix>

For further configuration options, see the [Build Options] page.