Building for macOS¶
1. Install dependencies¶
- Xcode with the Command Line Tools (
xcode-select --install) - CMake — install via the official installer or Homebrew:
- Python 3 for generated editor API suggestion files
2. Clone the repository¶
3. Configure and build¶
Using Ninja (single-config):
cmake -S . -B build -DCMAKE_BUILD_TYPE=Release -G "Ninja"
cmake --build build --config Release --target doriax-editor
The doriax-editor executable is created under build/.
Using the Xcode generator
To work inside Xcode, generate an Xcode project instead:
Xcode is a multi-config generator, so the build output is placed under a
configuration subdirectory such as build/Release/.
Runtime project build¶
macOS runtime builds default to Metal. When using the Xcode generator, the app backend defaults to the native Apple backend; otherwise it defaults to Sokol.
cmake -S engine -B build-runtime \
-DPROJECT_ROOT=/path/to/project \
-DCMAKE_BUILD_TYPE=Release \
-G "Ninja"
cmake --build build-runtime --config Release --target doriax-project
For Xcode:
cmake -S engine -B build-xcode -DPROJECT_ROOT=/path/to/project -G "Xcode"
cmake --build build-xcode --config Release --target doriax-project
The engine sets the macOS deployment target to 10.15 for runtime builds.