Compilar
Configuração manual de CMake para o motor e a C ABI, o workspace Rust que compila o Doppio, e os comandos de teste usados por CI e agentes.
Motor (C++20 + CMake)#
cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j
Para trabalho no editor, compile apenas a C ABI depois de alterar o motor:
cmake --build build --target caffeine-capi -j
Artefactos#
| Alvo | Saída | Função |
|---|---|---|
caffeine-core | build/libcaffeine-core.a | Biblioteca do motor sem ImGui nem código de editor. |
caffeine-capi | build/libcaffeine-capi.so / .dylib / .dll | C ABI estável carregada pelo Doppio e por frontends externos. |
caffeine-runtime | build/caffeine-runtime | Runtime autónomo em ImGui para cenas. |
caffeine-combined | build/caffeine-combined | Build combinada com a camada de suporte ao editor. |
caffeine-render-snapshot | build/caffeine-render-snapshot | Renderizador de cenas de referência para imagens de regressão visual. |
caf-encode | build/caf-encode | Encoder CAF legado; prefira a CLI caf-pack. |
| Plugins Doppio | build/plugins/*.so | Todos os plugins do submódulo doppio-plugins, carregados a pedido. |
Doppio (Rust 2021 + Iced 0.14)#
Compile primeiro a C ABI e depois o workspace:
cd doppio
cargo build -p doppio-ui
cargo run -p doppio-ui
Os binários ficam em doppio/target/<profile>/doppio e
doppio/target/<profile>/doppio-headless (este último requer a feature
headless). O perfil release é o usado pelo launcher:
cd doppio
cargo build --release -p doppio-ui
Opções comuns de CMake#
| Opção | Padrão | Efeito |
|---|---|---|
CAFFEINE_BUILD_HEADLESS | OFF | Compila caffeine-core sem SDL3 nem RHI para servidores e CI. |
CAFFEINE_ENABLE_SCRIPTING | ON | Lua 5.4 + sol2 e o sistema de scripts. |
CAFFEINE_ENABLE_BULLET3 | ON | Física de corpos rígidos com Bullet3. |
CAFFEINE_BUILD_DOPPIO_PLUGINS | ON | Compila todos os plugins de doppio-plugins para build/plugins; use OFF em builds mínimas ou headless. |
CMAKE_BUILD_TYPE | Debug | Use Release para trabalho no editor e benchmarks. |
Nota. Se o submódulo doppio-plugins faltar, a
configuração falha com uma mensagem explícita. Corra
./scripts/submodules.sh ou passe
-DCAFFEINE_BUILD_DOPPIO_PLUGINS=OFF.
Testes#
Motor C++#
cd build
ctest --output-on-failure
O binário Catch2 é build/tests/CaffeineTest; corra uma tag ou teste diretamente:
./build/tests/CaffeineTest "[ecs]"
Editor Rust#
cd doppio
cargo test -p doppio-ui
cargo test -p doppio-ui --features headless
A feature headless corre os flows de UI em doppio/tests/ui-flows/. A verificação
combinada usada em CI é:
./scripts/check-rust-ui.sh
Driver headless#
./scripts/doppio-headless.sh widgets
./scripts/doppio-headless.sh run doppio/tests/ui-flows --format text
Veja o guia headless para a referência de ações, capturas, baselines e gravação GIF/MP4.
Helpers de plataforma#
| Comando | Plataforma | O que faz |
|---|---|---|
./scripts/build.sh debug |
Linux/macOS | Configura e compila Debug |
./scripts/build.sh release |
Linux/macOS | Configura e compila Release |
./scripts/build.sh test |
Linux/macOS | Build Debug seguida de ctest |
./scripts/build.sh rebuild |
Linux/macOS | Remove build/, configura e compila |
./scripts/build.sh clean |
Linux/macOS | Remove build/ |
scripts\build.bat |
Windows | Helper de build para Windows |
./scripts/build.fish |
Fish shell | Variante para Fish |
./scripts/build-launcher.sh |
Linux/macOS | Compila o launcher Rust |
Limpeza#
rm -rf build doppio/target
Reconfigure depois de apagar build/. As caches do Cargo podem ser apagadas, mas
tornam o próximo build Rust mais lento.