Testes automatizados de jogos: combine verificações headless com evidência de renderização

Escolha a evidência de que você precisa

Uma build de jogo pode iniciar sem erros e, ainda assim, uma migração de save perder o inventário ou um shader renderizar um personagem de forma incorreta. Defina qual falha cada teste deve detectar. Use verificações focadas para as regras do jogo, verificações de integração para sistemas que interagem entre si e verificações de renderização para o comportamento visual. O framework de automação da Unreal distingue testes unitários, de funcionalidade, de estresse de conteúdo e de captura de tela. [2] O fato de uma categoria passar não comprova a cobertura das demais.

Torne a execução sem supervisão observável

A interface de linha de comando do Godot permite execução headless, scripts de projeto e uma operação de importação que aguarda a conclusão da importação de recursos antes de encerrar. [1] Um projeto pode usar esses elementos para montar um executor de testes sem supervisão. Faça esse executor retornar um status de saída de falha quando uma asserção falhar e preservar um relatório estruturado.

Verifique o caminho de falha durante a configuração, com uma fixture que falhe de propósito. Caso contrário, um job pode parecer bem-sucedido só porque iniciou um projeto vazio, ignorou uma opção não suportada ou nunca executou as verificações pretendidas. O sucesso em modo headless, por si só, não é evidência de que a GPU de destino produz os pixels corretos.

Exemplo com uma suíte pequena

Para um jogo de ação hipotético, escolha 20 testes de regras focados, quatro verificações de cena e três fixtures de renderização. Os testes de regras podem cobrir a capacidade do inventário e a elegibilidade para dano. As verificações de cena podem exercitar o spawn, a restauração de um checkpoint, a transição por uma porta e uma desconexão controlada. As fixtures de renderização podem conter uma superfície com normal map, partículas transparentes e uma fronteira de iluminação entre escuro e claro.

Reinicie cada fixture de forma independente. Registre seeds, ticks de simulação, versões de assets e as entradas relevantes. Repetir uma gravação ajuda a reproduzir falhas, mas uma seed fixa, por si só, não garante uma simulação idêntica entre plataformas. Esses números descrevem uma suíte proposta, não testes realizados em um jogo real.

Controle as comparações de capturas de tela

Fixe câmera, resolução, renderer, exposição e o ponto de captura. Use um job com GPU para a configuração de renderização pretendida. A ferramenta de capturas de tela da Epic oferece tolerâncias por canal e limites de erro tanto locais quanto globais, o que reflete o fato de que certas renderizações apresentam variação. [3]

Mantenha juntas a imagem de referência, a nova imagem e a imagem de diferença. Um erro global pequeno pode esconder um defeito local evidente, como um olho ou um ícone de interface ausente. Escolha os limites em função da falha que está sendo testada e trate mudanças na imagem de referência como mudanças de conteúdo, sujeitas a revisão. Substituir automaticamente todas as referências que falham apagaria a evidência do teste.

Mantenha a suíte útil

Execute com frequência as verificações rápidas e estáveis e reserve as varreduras caras de plataforma ou de conteúdo para uma periodicidade adequada. Isole os arquivos gerados e não presuma que outro teste deixou o mundo do jogo em um estado útil. [2] Nos relatórios, separe as falhas de infraestrutura das asserções de jogo que falharam.

Investigue os testes instáveis (flaky) em vez de aumentar todos os timeouts ou tolerâncias de imagem. Preserve a menor cena e a menor sequência de entradas que expliquem uma falha. A automação sustenta uma verificação repetível; já o playtest continua fornecendo evidências sobre a sensação de jogo, a legibilidade e situações que a suíte nunca codificou.

Fontes

[1] Godot command line tutorial — Godot Engine contributors.

[2] Automation Test Framework — Epic Games.

[3] Screenshot Comparison Tool — Epic Games.