Guia de build
O repositório traz pequenos wrappers de CMake em vez de uma ferramenta de build separada. Esta página documenta o que cada wrapper faz, os comandos exatos que executa e as verificações obrigatórias antes de um pull request.
Um comando#
./scripts/build.sh # Build Debug (padrão)
./scripts/build.sh release # Build Release
./scripts/build.sh test # Build Debug, depois ctest
./scripts/build.sh rebuild # Apaga build/, configura, compila
./scripts/build.sh clean # Apaga build/
Windows:
scripts\build.bat
scripts\build.bat release
scripts\build.bat test
Fish shell:
./scripts/build.fish release
Os wrappers são apenas conveniência; cada passo é um comando CMake normal.
O que o wrapper executa#
| Passo | Comando |
|---|---|
| Verificação de dependências | cmake e python3 no PATH |
| Configuração | cmake -DCMAKE_BUILD_TYPE=<tipo> .. a partir de build/ |
| Compilação | cmake --build . --parallel <cores> |
| Testes | ctest --output-on-failure |
O wrapper deteta os cores com nproc (Linux), sysctl (macOS) ou usa quatro como
fallback.
Compilar o Doppio#
O editor Rust não é compilado pelo CMake. Depois de existir a C ABI:
cmake --build build --target caffeine-capi -j
cd doppio
cargo build -p doppio-ui
cargo run -p doppio-ui
Para um binário release compatível com o launcher:
cd doppio
cargo build --release -p doppio-ui
# doppio/target/release/doppio
Plugins#
O build do motor compila todos os plugins do submódulo doppio-plugins para
build/plugins. Não existe um segundo passo de build de plugins:
./scripts/submodules.sh
./scripts/build.sh release
ls build/plugins
Para saltar plugins num ambiente mínimo ou headless:
cmake -S . -B build -DCAFFEINE_BUILD_DOPPIO_PLUGINS=OFF
Os plugins usam o SDK legado C++/ImGui em include/caffeine/plugin/ e
include/caffeine/ui/, não a UI Rust.
Testes e verificações#
cd build && ctest --output-on-failure
cd doppio && cargo test -p doppio-ui
./scripts/check-rust-ui.sh
check-rust-ui.sh corre:
cargo fmt --checkcargo testno workspacecargo check --features agentcargo clippy -- -D warnings- a auditoria de acoplamento
caffeine-core/ ImGui - a suite de flows headless
Verificações de UI headless:
./scripts/doppio-headless.sh run doppio/tests/ui-flows --format text
./scripts/doppio-headless.sh screenshot --annotate --out /tmp/doppio-shots
Verificações de documentação#
A partir de caffeine-website/:
python3 scripts/audit-docs.py --include-engine
python3 scripts/audit-docs-i18n.py
Estas verificações validam links, imagens, caminhos de código, regras HTML e a
estrutura EN/PT. Veja
DOCS_STYLE.md.
Resolução de problemas#
| Sintoma | Correção |
|---|---|
doppio-plugins submodule is missing | ./scripts/submodules.sh ou -DCAFFEINE_BUILD_DOPPIO_PLUGINS=OFF |
| SDL3 não encontrado | Instale SDL3 ou configure com -DCAFFEINE_BUILD_HEADLESS=ON para trabalho só no core |
O Doppio não carrega libcaffeine-capi | Compile o alvo caffeine-capi e defina CAFFEINE_ENGINE_ROOT se as árvores estiverem separadas |
| O build Rust falha após alterar a C ABI | Recompile a C ABI, depois cargo clean -p doppio-engine e volte a compilar |
| O renderer headless não arranca | Defina ICED_TEST_BACKEND=tiny-skia |