Clase 03 · Módulo 12
Pruebas de punta a punta con Maestro
Pruebas de punta a punta con Maestro
Qué logras en esta clase
Dejas escritos los recorridos críticos de tu app como archivos que una herramienta ejecuta sola, tocando la app igual que una persona.
- Eliges qué recorridos automatizar.
- Instalas Maestro y preparas el emulador correcto.
- Lees y escribes un flujo.
- Trabajas los flujos con Claude Code sin que queden frágiles.
02
Qué es una prueba de punta a punta
Hace lo que haría una persona: abre la app, toca, escribe y mira si aparece lo esperado. Si el recorrido completo funciona, pasa.
03
Lo que cubre y Jest no
| Jest | Maestro | |
|---|---|---|
| Dónde corre | En tu computador, sin app | En la app instalada |
| Comprueba | Una función o un componente | Un recorrido completo |
| Detecta | Lógica mal calculada | Navegación, sesión y servidor que no calzan |
| Velocidad | Segundos | Minutos |
Maestro es una herramienta de pruebas de punta a punta para apps móviles. Es la que Expo recomienda en su documentación.
04
Qué recorridos automatizar
Los que, si se rompen, dejan la app inservible:
- Registro e ingreso.
- La acción principal: reservar, pedir, publicar.
- El pago, en modo de prueba.
- Cerrar sesión y volver a entrar.
05
Dos formas de usar Maestro
| Maestro Studio | Maestro CLI | |
|---|---|---|
| Qué es | App de escritorio | Programa de terminal |
| Sistemas | Windows, macOS, Linux | Windows, macOS, Linux |
| Sirve para | Explorar la pantalla y armar flujos | Ejecutar flujos, también de forma automática |
| Requisito | El instalador | Java 17 o superior |
Puedes partir solo con Studio. La CLI se vuelve necesaria cuando Claude Code ejecuta los flujos por ti.
06
Instalar Maestro Studio
- Entra a la página de instalación de Maestro (está en las fuentes).
- Descarga el instalador de tu sistema:
MaestroStudio.exeen Windows,.dmgen macOS,.AppImageen Linux. - Ejecútalo y completa el asistente.
- Deja un emulador de Android abierto con tu app instalada.
- Abre Maestro Studio: debe detectar el emulador.
07
Instalar la CLI
La CLI (programa que se usa escribiendo comandos) necesita Java 17 o superior. Comprueba con java -version.
| Sistema | Instalación |
|---|---|
| macOS y Linux | Comando curl de la página oficial |
| Windows | Descargar maestro.zip, extraerlo y agregar su carpeta bin al PATH |
Verifica con maestro --help. Copia los comandos desde la página oficial: no los escribas de memoria ni desde un tutorial.
08
El emulador correcto
Al 18-11-2026, la documentación de Maestro lista emuladores de Android con API 29, 30, 31, 33 y 34. Los simuladores de iOS requieren Xcode, es decir, un Mac.
Desde Windows, tus flujos corren en Android. El recorrido es el mismo código.
09
Qué app prueba Maestro
Maestro abre una app ya instalada y la identifica por su identificador: el valor de android.package (o ios.bundleIdentifier) de tu app.json.
Conviene un build aparte para pruebas: un APK instalable en emulador, sin el menú de desarrollo. La guía de Expo usa un perfil propio en eas.json con android.buildType: "apk".
10
Anatomía de un flujo
Un flujo es un archivo YAML: texto con sangría, un comando por línea.
appId: cl.cafeteria.app
---
- launchApp
- tapOn: "Ingresar"
- tapOn: "Correo"
- inputText: "prueba@cafeteria.example"
- tapOn: "Contraseña"
- inputText: "clave-de-prueba"
- tapOn: "Entrar"
- assertVisible: "Mis pedidos"11
Cómo se lee ese flujo
appIddice qué app abrir.- La línea
---separa la configuración de los pasos. launchAppabre la app.- Cada
tapOntoca el elemento que muestra ese texto. inputTextescribe en el campo que quedó activo.assertVisiblecomprueba que aparezca «Mis pedidos». Si no aparece, el flujo falla.
12
Sin comprobación no hay prueba
Un flujo sin assertVisible solo confirma que la app no se cerró. No confirma que hizo lo correcto.
13
Comandos que más vas a usar
| Comando | Qué hace |
|---|---|
launchApp | Abre la app; puede partir con el estado limpio |
tapOn | Toca por texto, identificador o coordenada |
inputText | Escribe en el campo activo |
assertVisible | Exige que algo esté en pantalla |
scrollUntilVisible | Desliza hasta encontrar un elemento |
hideKeyboard | Cierra el teclado |
La lista completa y la sintaxis de cada opción están en la referencia de comandos.
14
Tocar por texto o por identificador
| Por texto | Por identificador | |
|---|---|---|
| Se escribe | tapOn: "Entrar" | tapOn con id: |
| Ventaja | Se lee como lo ve el usuario | No se rompe si cambias el texto |
| Conviene en | Botones y títulos estables | Íconos, campos, textos que cambian |
En React Native el identificador se asigna con la prop testID. Comprueba con «Inspect Screen» de Maestro Studio con qué identificador ve Maestro cada elemento.
15
Armar un flujo con Maestro Studio
- Con la app abierta en el emulador, usa «Inspect Screen».
- Haz clic sobre un elemento: Studio muestra su texto e identificador.
- Usa «Insert Command» para agregar el paso al flujo.
- Repite hasta completar el recorrido.
- Agrega la comprobación final.
- Ejecuta con «Run Locally» y guarda el archivo en tu proyecto.
16
Guardar y ejecutar desde la terminal
Los flujos van en una carpeta .maestro en la raíz del proyecto, junto a eas.json.
maestro test .maestro/ingreso.ymlSe ejecuta contra el emulador que esté abierto. Al terminar, cada paso aparece marcado como cumplido o fallido.
17
Datos de prueba y estado limpio
Un flujo debe dar el mismo resultado cada vez que corre.
- Usa un usuario creado solo para pruebas.
- Conecta ese build a tu proyecto Supabase de pruebas (módulo 7, clase 5).
- Parte cada flujo con la app en estado limpio.
- Usa datos que puedan repetirse.
18
Trabajar los flujos con Claude Code
- Describe el recorrido en pasos, con los textos exactos que ve el usuario.
- Pide que agregue
testIDa los elementos sin texto estable. - Pide el archivo del flujo en
.maestro. - Que lo ejecute con la CLI, o ejecútalo tú y pégale la salida completa.
- Revisa que la comprobación final represente el resultado real.
19
Por qué un flujo falla «a veces»
La causa habitual es el tiempo: el flujo busca un elemento antes de que llegue la respuesta del servidor o termine una animación.
assertVisiblereintenta por un rato antes de fallar.extendedWaitUntilespera más cuando una pantalla depende de la red.waitForAnimationToEndespera el fin de una animación.
20
Pocos flujos, bien elegidos
No conviertas cada caso en un flujo. La lógica fina se prueba con Jest en segundos; Maestro confirma que el camino completo sigue abierto.
21
Ejecutarlos en la nube, opcional
EAS Workflows (automatizaciones de Expo que corren en sus servidores) puede compilar la app y ejecutar tus flujos en cada pull request. Los archivos van en .eas/workflows/.
| Plan, al 18-11-2026 | Costo |
|---|---|
| Free | Hasta 60 minutos de CI/CD al mes |
| De pago | 0,05 USD por job de Maestro, más los minutos |
Para una primera app, ejecutarlos en tu computador antes de cada versión alcanza.
22
Lo que te llevas
- Maestro toca la app instalada y comprueba un recorrido completo.
- Un flujo es un archivo YAML con
appId, pasos y una comprobación. - Studio sirve para explorar y armar; la CLI, para ejecutar.
- Emulador con API 34, datos de prueba y estado limpio.
- Tres o cuatro flujos críticos valen más que treinta frágiles.
23
Hazlo ahora
Quince minutos:
- Instala Maestro Studio y abre tu emulador con la app instalada.
- Con «Inspect Screen», revisa la pantalla de ingreso y anota qué elementos no tienen texto ni identificador.
- Arma el flujo de ingreso con un usuario de prueba.
- Termina con un
assertVisiblede algo que solo existe después de entrar. - Ejecútalo dos veces seguidas. Si la segunda falla, revisa el estado inicial.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026