ci(capturas): workflow propio para las capturas, con snapshot en iOS y screengrab en Android

[Im-Fran]

Qué rompía el CI

Los tres jobs de capturas que fallan en el run 31809396713 —iPhone, iPad y Android— morían en el mismo punto, y no era ni fastlane ni el recorrido: los tres terminaban con All tests passed y las seis capturas escritas, y recién ahí reventaba scripts/generate-screenshot-backgrounds:46:

/home/runner/work/MiUTEM/MiUTEM/scripts/generate-screenshot-backgrounds: line 46: base: unbound variable

local base=$1 locale=$2 ancho=$3 alto=$4 textos=${5:-$base/$locale}

Bash declara todos los locales de una misma sentencia antes de evaluar las asignaciones, así que $base todavía no existe cuando se expande ${5:-$base/$locale}, y con set -u eso corta el script. macOS se salvaba de casualidad: su llamada (línea 91) pasa el quinto argumento, y ahí el valor por defecto nunca se evalúa. Por eso screenshots-macos está en verde en los tres intentos del run.

Qué cambia

1. screenshots.yml. Los tres jobs de capturas salen de deploy.yml y quedan en un workflow propio, con los mismos disparadores de antes (push a dev y prod, más workflow_dispatch) y las mismas condiciones de [skip screenshots]. deploy.yml queda sólo con determine-environment y los deploy-*.

2. El recorrido de cada plataforma pasa a la herramienta de fastlane que le corresponde, siguiendo docs.fastlane.tools:

Plataforma	Herramienta	Recorrido
iPhone y iPad	snapshot	ios/RunnerUITests/ScreenshotsUITests.swift
Android	screengrab	android/app/src/androidTest/kotlin/cl/inndev/miutem/ScreenshotsTest.kt
macOS	flutter drive (sin cambios)	integration_test/screenshots_test.dart

En iOS se siguió el Quick Start de snapshot tal cual: target de UI Tests nuevo (RunnerUITests), SnapshotHelper.swift oficial dentro del target, setupSnapshot(app) + app.launch(), un snapshot("...") por pantalla y la configuración fija en fastlane/Snapfile. En Android, la dependencia tools.fastlane:screengrab, los permisos que pide la guía en el manifest de debug, LocaleTestRule + Screengrab.screenshot(...) en un test JUnit4, y fastlane/Screengrabfile.

macOS se queda con flutter drive porque snapshot recorre la app con un simulador de iOS y para el escritorio no hay equivalente en la documentación.

3. Los --dart-define llegan por otro camino. snapshot compila con xcodebuild, que no entiende --dart-define, así que el lane deja antes los defines en ios/Flutter/Generated.xcconfig con flutter build ios --config-only. En Android el APK de la app lo compila flutter build apk (por los defines) y el de los tests, gradle.

4. La app publica su semántica en modo capturas. Los dos recorridos nativos manejan la app por el árbol de accesibilidad, y Flutter sólo lo publica cuando el sistema declara un cliente de accesibilidad activo: SemanticsBinding.instance.ensureSemantics(), detrás de modoCapturas.

Lo que no cambia: las capturas siguen quedando en la misma carpeta y con el mismo nombre (<Dispositivo>-<pantalla>.png en iOS), y encima siguen corriendo los fondos, frameit y la composición de las dos primeras.

Qué falta verificar

Esto necesita una corrida real: acá no hay macOS, Xcode ni emulador, así que el arreglo del script está probado, pero los dos recorridos nuevos no. Lo que hay que mirar en el primer run:

• iOS: que XCUITest encuentre los campos del login (Flutter los publica como textField / secureTextField) y que el botón de volver de la AppBar aparezca con alguna de las etiquetas que se prueban (Atrás, Back, Volver); si no, cae al gesto de arrastrar desde el borde.
• iOS: la app anima siempre (video del login, skeletons). Por eso va setupSnapshot(app, waitForAnimations: false), pero la espera de inactividad que hace XCUITest por su cuenta es lo primero que podría dar problemas.
• Android: que UiObject2.setText escriba en los campos de Flutter y que las etiquetas de los accesos rápidos lleguen como contentDescription.

Los mensajes de error de los dos recorridos dicen qué se estaba esperando, así que un fallo debería quedar claro en el log sin tener que adivinar.

---

Generated by Claude Code

[github-actions]

📸 Capturas de pantalla

Así quedó la app con los datos de demostración. Las imágenes no se pueden mostrar acá —GitHub no deja adjuntarlas desde la API—, así que van en los artefactos del run.

📱 iPhone

7 capturas:

Captura	Tamaño
iPhone 17 Pro Max-03_oscuro.png	1320×2868
iPhone 17 Pro Max-04_calculadora.png	1320×2868
iPhone 17 Pro Max-05_inicio.png	1320×2868
iPhone 17 Pro Max-06_credencial.png	1320×2868
iPhone 17 Pro Max-07_horario.png	1320×2868
iPhone 17 Pro Max-08_malla.png	1320×2868
Apple MacBook Pro 16 Space Gray.png	3910×2241

📦 Descargar el artefacto (incluye también las enmarcadas para la tienda)

📱 iPad

7 capturas:

Captura	Tamaño
iPad Air 13-inch (M4)-03_oscuro.png	2048×2732
iPad Air 13-inch (M4)-04_calculadora.png	2048×2732
iPad Air 13-inch (M4)-05_inicio.png	2048×2732
iPad Air 13-inch (M4)-06_credencial.png	2048×2732
iPad Air 13-inch (M4)-07_horario.png	2048×2732
iPad Air 13-inch (M4)-08_malla.png	2048×2732
Apple MacBook Pro 16 Space Gray.png	3910×2241

📦 Descargar el artefacto (incluye también las enmarcadas para la tienda)

🤖 Android

6 capturas:

Captura	Tamaño
03_oscuro.png	1080×2160
04_calculadora.png	1080×2160
05_inicio.png	1080×2160
06_credencial.png	1080×2160
07_horario.png	1080×2160
08_malla.png	1080×2160

📦 Descargar el artefacto (incluye también las enmarcadas para la tienda)

🖥️ macOS

6 capturas:

Captura	Tamaño
03_oscuro.png	2880×1806
04_calculadora.png	2880×1806
05_inicio.png	2880×1806
06_credencial.png	2880×1806
07_horario.png	2880×1806
08_malla.png	2880×1806

📦 Descargar el artefacto (incluye también las enmarcadas para la tienda)