Automação de testes do editor
O Doppio é testado conduzindo a árvore de widgets real fora do ecrã: scripts JSON simples, input humano, asserções, capturas, baselines e gravações GIF/MP4. Não existe um harness Python separado.
Nota. Revisões antigas desta página descreviam um bridge Python
editor_test_automation.py. Esse harness já não existe. O caminho
suportado é doppio-headless e os flows de UI comprometidos.
As três camadas#
| Camada | Localização | Executa |
|---|---|---|
| Flow | doppio/tests/ui-flows/*.json | Em cada cargo test através de every_shipped_flow_passes e de scripts/check-rust-ui.sh. |
| Driver | doppio/crates/ui/src/windows/main/headless/ | Ações, targets, snapshots de estado, capturas e gravação. |
| CLI | scripts/doppio-headless.sh | Qualquer shell, job de CI ou agente; nenhuma janela abre. |
Correr os flows#
./scripts/doppio-headless.sh run doppio/tests/ui-flows --format text
Cada flow tem a sua pasta de artefactos. Um passo falhado imprime a ação, o target, as
mensagens produzidas e uma dica. Códigos de saída: 0 passou, 1 falha de passo ou
asserção, 2 erro de uso ou JSON inválido.
Escrever um flow#
{
"name": "Abrir o menu Scene e adicionar uma entidade",
"description": "Protege o encaminhamento de teclado e menus para a ação de adicionar.",
"fixture": "entities",
"size": [1280, 720],
"steps": [
{ "action": "click", "target": "id:editor.menu.scene" },
{ "action": "expect", "state": { "/menu": "Scene" }, "exists": "text:Add Entity" },
{ "action": "click", "target": "id:editor.add_entity" },
{ "action": "expect", "count": { "prefix": "hierarchy.list.entity_row.", "at_least": 3 } },
{ "action": "screenshot", "name": "after-add", "annotate": true }
]
}
Regras:
- Comece numa fixture (
entities,empty,material,texture,scene3d,nature,water,terrain). - Use ids do catálogo (
id:...), não pontos, exceto quando o ponto é o comportamento em teste. - Faça asserções após cada ação relevante; ponha um
labelnas asserções para que as falhas sejam legíveis. - Guarde capturas como artefactos; use
baselinesó quando o visual é o objetivo. - Nomeie o bug que o flow protege em
description.
Inspecionar a UI#
./scripts/doppio-headless.sh widgets --size 1440x800
./scripts/doppio-headless.sh screenshot --annotate --name workspace --out /tmp/shots
widgets lista ids, tipos e bounds. screenshot --annotate numera todos os widgets
catalogados e acrescenta a legenda n. id — descrição. O mesmo catálogo alimenta a
referência de UI.
Capturar imagens para documentação#
Os flows de captura comprometidos vivem em doppio/docs/flows/capture-*.json. Os
wrappers shell removem o prefixo numérico para os nomes das imagens ficarem estáveis:
./scripts/capture-material-docs.sh
./scripts/capture-nature-docs.sh
./scripts/capture-terrain-docs.sh
./scripts/capture-texture-docs.sh
./scripts/capture-water-docs.sh
./scripts/capture-gizmo-docs.sh
./scripts/capture-editor-tour.sh # tour curto MP4/GIF
Um flow de captura é um flow normal mais passos screenshot com target, padding
e scale. Veja doppio/docs/flows/capture-gizmo-docs.json para o padrão scene3d.
Gravar GIFs e vídeos#
record_start / record_stop capturam a janela ou um widget e codificam com ffmpeg:
{ "steps": [
{ "action": "record_start", "name": "dock", "format": "mp4", "fps": 30, "target": "id:editor.pane.viewport" },
{ "action": "drag", "from": "id:editor.pane.tab.console", "to": "point:900,300" },
{ "action": "wait", "ms": 1200, "real_time": true },
{ "action": "record_stop" }
] }
format aceita gif, mp4 e webm; width, scale, fps e keep_frames
controlam a saída. Uma gravação deixada aberta no fim do script é finalizada
automaticamente.
Regras de regressão#
- Uma correção ou feature visível acrescenta um flow em
doppio/tests/ui-flows/. - O flow tem de passar em
cargo teste emscripts/check-rust-ui.sh. - Widgets novos recebem um
UiIde uma entrada emCATALOG; caso contrário não podem ser alvo, anotados ou documentados. - Alterações visuais regeneram as imagens do flow de captura afetado; não edite PNGs à mão.
Páginas relacionadas#
- Referência de headless testing — todas as ações, formas de target, chaves de estado e opções de captura.
- Referência de UI — ids e legendas gerados.
- Compilar — binários de teste e feature flags.