Caffeine

Compilar

Stable Engine Doppio Verificado em:

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)#

bash
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:

bash
cmake --build build --target caffeine-capi -j

Artefactos#

AlvoSaídaFunção
caffeine-corebuild/libcaffeine-core.aBiblioteca do motor sem ImGui nem código de editor.
caffeine-capibuild/libcaffeine-capi.so / .dylib / .dllC ABI estável carregada pelo Doppio e por frontends externos.
caffeine-runtimebuild/caffeine-runtimeRuntime autónomo em ImGui para cenas.
caffeine-combinedbuild/caffeine-combinedBuild combinada com a camada de suporte ao editor.
caffeine-render-snapshotbuild/caffeine-render-snapshotRenderizador de cenas de referência para imagens de regressão visual.
caf-encodebuild/caf-encodeEncoder CAF legado; prefira a CLI caf-pack.
Plugins Doppiobuild/plugins/*.soTodos 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:

bash
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:

bash
cd doppio
cargo build --release -p doppio-ui

Opções comuns de CMake#

OpçãoPadrãoEfeito
CAFFEINE_BUILD_HEADLESSOFFCompila caffeine-core sem SDL3 nem RHI para servidores e CI.
CAFFEINE_ENABLE_SCRIPTINGONLua 5.4 + sol2 e o sistema de scripts.
CAFFEINE_ENABLE_BULLET3ONFísica de corpos rígidos com Bullet3.
CAFFEINE_BUILD_DOPPIO_PLUGINSONCompila todos os plugins de doppio-plugins para build/plugins; use OFF em builds mínimas ou headless.
CMAKE_BUILD_TYPEDebugUse 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++#

bash
cd build
ctest --output-on-failure

O binário Catch2 é build/tests/CaffeineTest; corra uma tag ou teste diretamente:

bash
./build/tests/CaffeineTest "[ecs]"

Editor Rust#

bash
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 é:

bash
./scripts/check-rust-ui.sh

Driver headless#

bash
./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#

bash
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.