Caffeine

Testes

Stable Engine Doppio Verificado em: Fonte: tests/CMakeLists.txt

Três camadas de teste: Catch2 para o motor, testes Rust unitários e de integração para o Doppio, e flows de UI headless que conduzem a árvore de widgets real sem janela. O CI corre as três.

Camadas#

CamadaFrameworkComandoLocalização
Motor C++Catch2 v3ctest --output-on-failuretests/, binário build/tests/CaffeineTest
Editor Rustcargo testcd doppio && cargo testdoppio/crates/ui/src/windows/main/tests.rs, testes da crate do motor
Flows de UI headlessdoppio-headless./scripts/check-rust-ui.shdoppio/tests/ui-flows/*.json

Suite C++#

bash
cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j
cd build && ctest --output-on-failure

Corra uma tag ou teste diretamente:

bash
./build/tests/CaffeineTest "[ecs]"
./build/tests/CaffeineTest "World *" --success

Os testes têm tags; [stress] marca os casos longos que o CI só corre num workflow_dispatch manual. A suite cobre tipos do core, allocators, containers, matemática, ECS, jobs, assets, RHI, física, áudio, animação, scripting, terreno e a C ABI.

Suite do editor Rust#

bash
cd doppio
cargo test
cargo test -p doppio-ui --features headless

A feature headless corre os flows comprometidos através de every_shipped_flow_passes. A suite do editor cobre mensagens de App, estado de painéis/docking, edições no inspector, pesquisa na hierarchy, gestos do viewport, filtros da console, asset wizard e os grafos dos geradores.

Flows de UI headless#

bash
./scripts/doppio-headless.sh run doppio/tests/ui-flows --format text

Cada flow começa numa fixture determinística, age com targets id:/text: e verifica com expect. Capturas, baselines e gravação GIF/MP4 estão disponíveis para trabalho visual. Veja Headless testing e Automação de testes.

CI#

.github/workflows/test.yml corre em pushes para main, develop e feature/**, e em pull requests para main/develop:

  1. configurar e compilar com GCC 13;
  2. ./build/tests/CaffeineTest ~[stress] --success;
  3. ./scripts/check-rust-ui.sh;
  4. opcionalmente ./build/tests/CaffeineTest "[stress]" --success em dispatch manual.

Uma alteração está pronta quando a suite C++ e as verificações Rust/headless passam. Uma mudança visível no editor acrescenta um flow; uma mudança de comportamento do motor acrescenta um caso Catch2.

Escrever testes#

Convenções Catch2
  • Um ficheiro por módulo: tests/test_<module>.cpp.
  • Use TEST_CASE("Behaviour", "[module]") e SECTION para variantes.
  • Prefira dados determinísticos; sem sleeps, janelas GPU reais ou rede.
  • Marque casos lentos com [stress] para o CI padrão os saltar.
Convenções dos flows headless
  • Comece em entities, empty ou numa fixture de gerador.
  • Use ids do catálogo, não pontos de ecrã, exceto quando o ponto é o comportamento.
  • Faça asserções após cada ação relevante e rotule a asserção.
  • Guarde capturas como artefactos; use baselines só para regressões visuais.

Páginas relacionadas#