Build Guide

SparkEngine Build Guide

Audience: Programmers and contributors

Thread Context: Not applicable — build workflow

Platform/Backend Scope: Windows primary; Linux and macOS experimental

Supported build path

SparkEngine requires CMake 3.25+ and a C++23-capable compiler. Windows 10+ with MSVC is the primary platform; Linux and macOS support is experimental.

Choose the preset for the host platform and use its matching build directory:

# Windows
cmake --preset windows-release
cmake --build --preset windows-release
ctest --test-dir build/windows-release -C Release --output-on-failure

# Linux
cmake --preset linux-gcc-release
cmake --build --preset linux-gcc-release
ctest --test-dir build/linux-gcc-release --output-on-failure

# macOS
cmake --preset macos-release
cmake --build --preset macos-release
ctest --test-dir build/macos-release --output-on-failure

Read before building

• Getting Started — prerequisites and the normal build sequence.
• System Requirements — supported hardware and platforms.
• Build System and CMake Modules — presets, options, and CMake architecture.
• Cross-Compilation and Wine Testing — Windows-target builds from Linux.
• CI Reproducible Builds — commands matching continuous integration.
• Troubleshooting — common configure, build, runtime, and graphics failures.

The authoritative preset definitions are in CMakePresets.json.

Source & Freshness

This guide summarizes the canonical presets on Working; CMakePresets.json and the linked platform pages are authoritative for exact options.