Pruebas automatizadas de UI

El framework de pruebas de CrossFly no es JUnit. Cada TestCase se ejecuta dentro del runtime gráfico (paint thread, EventsProcessor, pipeline GL), y la aserción principal es la comparación visual de screenshots contra imágenes-referencia (golden images). Portal al Capítulo 31.

Anatomía de un TestCase

public class LoginTest extends TestCase {
   @Override protected void load() throws Exception {
      new LoginScreen().show();        // arma la pantalla bajo prueba
   }
   @Override public void runTests() throws Exception {
      waitWindow(LoginScreen.class);
      type(0, TextField.class, "[email protected]");   // escribe en el 1er TextField
      type(1, TextField.class, "senha123");
      click("Entrar");                 // hace clic en el botón con ese texto
      shot();                          // captura y compara con el golden
      waitWindow(HomeScreen.class);
      shot();
   }
   @Override protected void unload() { /* limpia el estado */ }
}

Interacción: click(...), type(...), enter(), penDown/penUp/penDrag(...), setText(...). Descubrimiento: find(index, Classe) / find(texto, Classe). Sincronización: waitWindow(...), waitAnimation(), waitUIidle(...).

Agrupar y ejecutar — TestSuite

TestSuite suite = new TestSuite();
suite.startTests(new TestCase[]{ new LoginTest(), new CadastroTest() });

La suite ejecuta cada prueba, compara los shot() con los goldens y reporta (success/fail/log).

⚠️ El determinismo es un prerrequisito: DeviceConfig.isTesting

La comparación píxel-a-píxel solo coincide si el renderizado es determinístico. Activa DeviceConfig.isTesting = true — eso fija el cursor, elimina timestamps y hace que TimePicker/reloj sean estables. Sin eso, el golden nunca coincide (cursor parpadeando, hora actual, etc. cambian la imagen).

Sin UI: WindowlessTestCase

Para lógica que no necesita pantalla (repository, formato), extiende WindowlessTestCase — se ejecuta en el runtime, pero sin montar UI.

Generar las imágenes de la doc

Los mismos screenshots de prueba sirven para generar las imágenes de la documentación/tienda: Main.getScreenShot(true).toPng("prefixo_").

Buenas prácticas

• Siempre DeviceConfig.isTesting = true en la batería de pruebas.
• Usa waitWindow(...)/waitAnimation() antes de shot() — captura un frame estable.
• Un golden por estado visual relevante; regenéralos al cambiar la UI a propósito.

Errores comunes

• Golden que “desaparece a veces sí, a veces no” → faltó isTesting/waitAnimation (frame inestable).
• shot() antes de que la ventana esté totalmente visible.