Maestro E2E

Q: ¿Dónde viven los archivos de flujo?

Convención: .maestro/ en la raíz del proyecto (hermano de eas.json). Nombra flujos por viaje (login.yml, checkout-guest.yml), no por número de sprint.

Q: ¿Qué es el separador --- en flujos YAML?

Las líneas arriba de --- son configuración (appId, name opcional, env). Las líneas debajo son la lista de comandos ejecutada en orden.

Q: ¿Cómo sabe EAS qué binario de aplicación instalar?

El build_id del job maestro hace referencia al artefacto del job build en el mismo workflow. Compila con el perfil e2e-test para que la salida sea un .apk o simulador .app instalable.

Q: ¿Cómo objetivo un elemento con texto duplicado?

Agrega testID en React Native. Prefiere id sobre toques de coordenadas - las coordenadas se rompen entre tamaños de pantalla.

Q: ¿Puede Maestro rellenar campos de texto seguro?

Sí - inputText funciona en campos seguros enfocados. Asegúrate de que el campo sea tocado primero. Prueba en ambas plataformas; el comportamiento del teclado difiere en el simulador iOS.

Q: ¿Cómo reutilizo una secuencia de login?

Mantén subflujos en .maestro/subflows/ y hace referencia con runFlow.

Maestro controla tu aplicación instalada en un simulador o emulador con flujos YAML declarativos - presiona, desplázate, afirma texto visible - sin escribir código de arnés de prueba nativo. Combínalo con compilaciones EAS para que cada PR ejecute los mismos viajes que CI ejecuta localmente.

Receta

Tarjeta de referencia rápida - lista para copiar y pegar.

# .maestro/login.yml
appId: com.yourcompany.yourapp
---
- launchApp
- tapOn: "Sign in"
- tapOn:
    id: "email-input"
- inputText: "alex@example.com"
- tapOn: "Continue"
- assertVisible: "Welcome back.*"

// eas.json (excerpt)
{
  "build": {
    "e2e-test": {
      "withoutCredentials": true,
      "ios": { "simulator": true },
      "android": { "buildType": "apk" }
    }
  }
}

# .eas/workflows/e2e-test-android.yml
name: e2e-test-android
on:
  pull_request:
    branches: ["*"]
jobs:
  build_android_for_e2e:
    type: build
    params:
      platform: android
      profile: e2e-test
  maestro_test:
    needs: [build_android_for_e2e]
    type: maestro
    params:
      build_id: ${{ needs.build_android_for_e2e.outputs.build_id }}
      flow_path: [".maestro/login.yml"]

Cuándo usarlo:

Viajes de usuario críticos: login, checkout, onboarding, deep links de notificaciones push.
Flujos que cruzan chrome nativo - permisos del SO, barras de pestañas, teclados del sistema.
Compuertas de regresión antes de envío a store (complementan Mejores prácticas de pruebas).
Equipos que quieren que los no desarrolladores lean y amplíen escenarios de prueba en YAML.

Ejemplo de trabajo

Diseño del proyecto:

your-expo-app/
  .maestro/
    home.yml
    explore-collapsible.yml
  .eas/
    workflows/
      e2e-test-android.yml
      e2e-test-ios.yml
  eas.json
  app.json

// app.json (excerpt - fuente de verdad appId)
{
  "expo": {
    "name": "Tasks Demo",
    "slug": "tasks-demo",
    "ios": { "bundleIdentifier": "com.example.tasksdemo" },
    "android": { "package": "com.example.tasksdemo" }
  }
}

# .maestro/home.yml
appId: com.example.tasksdemo
---
- launchApp
- assertVisible: "Welcome!"
- tapOn: "Tasks.*"
- assertVisible: "No tasks yet"

# .maestro/explore-collapsible.yml
appId: com.example.tasksdemo
---
- launchApp
- tapOn: "Explore.*"
- tapOn: ".*File-based routing"
- assertVisible: "This app has two screens.*"
- scrollUntilVisible:
    element: "Learn more"
    direction: DOWN

// eas.json
{
  "build": {
    "e2e-test": {
      "withoutCredentials": true,
      "ios": {
        "simulator": true
      },
      "android": {
        "buildType": "apk"
      }
    }
  }
}

# .eas/workflows/e2e-test-android.yml
name: e2e-test-android
 
on:
  pull_request:
    branches: ["*"]
 
jobs:
  build_android_for_e2e:
    type: build
    params:
      platform: android
      profile: e2e-test
 
  maestro_test:
    needs: [build_android_for_e2e]
    type: maestro
    params:
      build_id: ${{ needs.build_android_for_e2e.outputs.build_id }}
      flow_path:
        - ".maestro/home.yml"
        - ".maestro/explore-collapsible.yml"

# Ejecución local (después de instalar Maestro CLI y una compilación de debug en emulador/simulador)
maestro test .maestro/home.yml
maestro test .maestro/
 
# Ejecutar EAS Workflow manualmente
npx eas-cli@latest workflow:run .eas/workflows/e2e-test-android.yml

Lo que esto demuestra:

appId coincide con android.package / ios.bundleIdentifier de app.json.
Coincidentes Regex - Tasks.* y Explore.* toleran cambios menores de etiqueta y diferencias de texto de plataforma.
Perfil de compilación e2e-test - produce .apk (Android) y simulador .app (iOS) sin credenciales de store.
Job EAS maestro - instala el artefacto de compilación desde build_id y ejecuta flujos flow_path.
Flujos independientes - cada archivo YAML es un viaje; los fallos señalan la pantalla rota.

Profundización

Cómo funciona

Maestro CLI se conecta a un emulador/simulador en ejecución (o dispositivo físico) e inicia la aplicación por appId.
Cada flujo es una lista ordenada de comandos (launchApp, tapOn, inputText, assertVisible, scrollUntilVisible, ...) ejecutados contra el árbol de UI en vivo.
Maestro usa etiquetas de accesibilidad y texto visible - agrega testID / accessibilityLabel en React Native cuando solo el texto es ambiguo.
EAS Workflows type: build produce un binario instalable; type: maestro descarga ese binario al runner y ejecuta flujos - sin carga manual de artefactos.
Los flujos son caja negra - no importan tu JS; cambiar la implementación no rompe las pruebas si la UI visible para el usuario permanece igual.

Comandos comunes de flujo

Comando	Propósito
`launchApp`	Arranque en frío (o reanudar) la aplicación bajo prueba
`tapOn`	Presiona por texto, id, o regex (`"Sign in"`, `id: "submit-btn"`)
`inputText`	Escribe en el campo enfocado
`assertVisible` / `assertNotVisible`	Falla rápido si falta el texto o id
`scrollUntilVisible`	Desplázate hasta que aparezca el elemento - listas y pantallas largas
`runFlow`	Compone subflujos para pasos de login compartidos
`extendedWaitUntil`	Espera al elemento con tiempo de espera - puertas de carga asincrónica

Opciones de integración con CI

Enfoque	Ventajas	Desventajas
Job `maestro` de EAS Workflows	Integración nativa Expo, compilación + prueba vinculadas	Requiere suscripción EAS y configuración de workflow
GitHub Actions + `maestro test`	Control total de runners	Tú administras arranque de emulador, instalación de APK y caching
`maestro test` local antes de PR	Retroalimentación más rápida	No se aplica a menos que CI también se ejecute

Expo documenta la ruta de EAS Workflows en Ejecutar pruebas E2E en EAS Workflows con Maestro.

Controles de pruebas inestables

# .maestro/checkout.yml
appId: com.example.tasksdemo
---
- launchApp
- extendedWaitUntil:
    visible: "Catalog"
    timeout: 15000
- tapOn:
    id: "product-card-1"
- assertVisible: "Add to cart"

Técnica	Cuándo
Regex (`Welcome.*`)	Pequeñas diferencias de puntuación o cadenas de plataforma
`extendedWaitUntil`	Pantallas cargadas por red, transición splash - home
`id:` / `testID`	Texto visible duplicado en pantalla
Flujos cortos y enfocados	Aísla el fallo - evita mega-flujos de 40 pasos
`runFlow` para login una vez	DRY sin fusionar aserciones no relacionadas
Cuentas de prueba estables / datos iniciales	El estado backend no debe depender de producción

Rastrea la tasa de flakes con el tiempo usando Maestro insights en EAS - reintenttos sin arreglar la causa raíz ocultan bugs de producto.

Notas de React Native

// Prefiere selectores estables que Maestro pueda dirigirse
<Pressable
  testID="sign-in-button"
  accessibilityLabel="Sign in"
  onPress={handleSignIn}
>
  <Text>Sign in</Text>
</Pressable>

- tapOn:
    id: "sign-in-button"

testID se asigna a id en Maestro - usa kebab-case consistentemente entre plataformas.
Expo Go vs cliente dev vs compilaciones de lanzamiento - appId difiere; CI debe probar el mismo tipo de binario que envías (perfil EAS e2e-test, no Expo Go).
Animaciones - espera contenido con extendedWaitUntil en lugar de comandos sleep fijos.
Teclado - inputText después de enfocar un campo; en el simulador iOS asegúrate de que el teclado de software esté habilitado para ejecuciones realistas.

Errores comunes

appId incorrecto - El flujo inicia una aplicación diferente o falla inmediatamente. Arreglo: Copia android.package / ios.bundleIdentifier de app.json después de eas build:configure, no el slug de Expo.
Pruebas en Expo Go con appId de producción - El ID de aplicación de Expo Go es host.exp.exponent, no tu ID de paquete. Arreglo: Instala una compilación EAS dev o preview en el emulador antes de maestro test.
Mega-flujos que son difíciles de depurar - Un archivo YAML cubriendo onboarding - paywall - settings oculta qué paso falló. Arreglo: Un viaje por archivo; comparte login vía runFlow.
Aserciones de cadena exacta frágiles - "Welcome" falla cuando el texto se convierte en "Welcome!" o incluye espacio final. Arreglo: Aserciones Regex (Welcome!, Welcome.*) y testID para toques críticos.
Estado backend compartido entre flujos - Los ejecutores paralelos de CI mutan el mismo usuario de prueba. Arreglo: Inquilinos de prueba dedicados, scripts iniciales idempotentes, o cuentas por ejecución.
Sin esperar contenido asincrónico - assertVisible se ejecuta antes de que se complete la búsqueda - fallos intermitentes. Arreglo: extendedWaitUntil o assertVisible después de que desaparezca un indicador de carga estable.
Asumir que Maestro reemplaza Jest - E2E es lento y no cubre cada rama. Arreglo: Mantén pruebas de unidad/componente (Jest Setup para Expo, RNTL); usa Maestro para rutas críticas delgadas.

Alternativas

Alternativa	Usar cuándo	No usar cuándo
Maestro	YAML-friendly E2E, autoría rápida, integración EAS Expo	Necesitas ganchos de sincronización nativa profunda dentro de la aplicación
Detox	Pruebas de caja gris esperando inactividad JS/nativa	El equipo quiere cero código de prueba nativo y configuración mínima
Checklist de QA manual	Pasadas exploratorias antes de lanzamientos mayores	Regresión en cada PR - no escala
RNTL + `renderRouter`	Lógica de enrutamiento sin costo de emulador	Diálogos de permiso del SO o gestos reales
Appium	Estándar empresarial de pila cruzada ya en vigor	Equipo Expo greenfield queriendo ceremonia más baja

FAQs

¿Cómo instalo Maestro localmente?

Sigue Instalar Maestro CLI. Necesitas un emulador/simulador iniciado con tu binario de aplicación instalado antes de maestro test.

¿Dónde viven los archivos de flujo?

Convención: .maestro/ en la raíz del proyecto (hermano de eas.json). Nombra flujos por viaje (login.yml, checkout-guest.yml), no por número de sprint.

¿Qué es el separador --- en flujos YAML?

Las líneas arriba de --- son configuración (appId, name opcional, env). Las líneas debajo son la lista de comandos ejecutada en orden.

¿Cómo ejecuto todos los flujos?

maestro test .maestro/

Ejecuta cada flujo en el directorio. En CI, lista rutas explícitas en flow_path para que borradores experimentales no se recojan accidentalmente.

¿Cómo sabe EAS qué binario de aplicación instalar?

El build_id del job maestro hace referencia al artefacto del job build en el mismo workflow. Compila con el perfil e2e-test para que la salida sea un .apk o simulador .app instalable.

¿Puedo ejecutar Maestro en iOS y Android en un workflow?

Usa archivos de workflow separados (o jobs) por plataforma - compilaciones platform: ios vs platform: android producen artefactos diferentes. Comparte flujos YAML cuando la paridad de UI es cercana; rama con flujos específicos de plataforma cuando no es así.

¿Cómo objetivo un elemento con texto duplicado?

- tapOn:
    id: "submit-button"

Agrega testID en React Native. Prefiere id sobre toques de coordenadas - las coordenadas se rompen entre tamaños de pantalla.

¿Cómo manejo spinners de carga?

- extendedWaitUntil:
    visible: "Dashboard"
    timeout: 20000

Espera la pantalla post-carga - no el spinner mismo - para que redes rápidas no hagan flake en la visibilidad del spinner.

¿Puede Maestro rellenar campos de texto seguro?

Sí - inputText funciona en campos seguros enfocados. Asegúrate de que el campo sea tocado primero. Prueba en ambas plataformas; el comportamiento del teclado difiere en el simulador iOS.

¿Cómo reutilizo una secuencia de login?

# .maestro/subflows/login.yml
- tapOn: "Sign in"
- inputText: "test@example.com"
# ...
 
# .maestro/checkout.yml
- runFlow: subflows/login.yml
- tapOn: "Checkout"

Mantén subflujos en .maestro/subflows/ y hace referencia con runFlow.

¿Qué perfil de compilación debe usar e2e-test?

withoutCredentials: true - compilaciones internas de CI sin configuración de firma de store.
Android buildType: "apk" - instalable en emulador sin danza de firma de Play.
iOS simulator: true - produce un simulador .app, no un IPA de App Store.

¿Maestro vs Detox para Expo SDK 57?

Maestro: YAML, caja negra, tipo de job EAS Workflow, configuración baja. Detox: pruebas JS, sincronización de caja gris, configuración de compilación nativa - ver Detox E2E cuando necesites IDs de prueba en aplicación e sincronización de inactividad.

¿Cómo reduzco flakes en CI?

Fija el nivel de API del emulador en CI para que coincida con dev local.
Siembra datos backend antes de flujos.
Usa extendedWaitUntil para pantallas vinculadas a la red.
Divide flujos largos; las políticas de reintento ayudan pero arregla problemas de sincronización raíz primero.

¿Debo confirmar .maestro en git?

Sí - los flujos son código fuente. Revísalos como cambios de aplicación. Excluye la salida de debug local de Maestro o grabaciones de pantalla si tu equipo las genera durante el desarrollo.

¿Cuántos flujos E2E necesito?

Cubre rutas críticas solamente - autenticación, pago, pérdida de datos, pantallas regulatorias. La cobertura de rama exhaustiva permanece en Jest. Ver Conceptos básicos de pruebas móviles para el balance de pirámide.

Relacionado

Conceptos básicos de pruebas móviles - dónde se ubica E2E en la pirámide de pruebas
Jest Setup para Expo - pruebas rápidas de unidad que Maestro no reemplaza
React Native Testing Library - pruebas de componentes bajo E2E
Detox E2E - alternativa de caja gris cuando Maestro no es suficiente
Integración de GitHub Actions - runners de CI no EAS con Maestro
Conceptos básicos de EAS Build - perfiles de compilación que alimentan jobs E2E

Versiones de pila: Esta página fue escrita para React 19.2.3, React Native 0.86.0, y Expo SDK 57 (expo ~57.0.4).

Receta

Tarjeta de referencia rápida - lista para copiar y pegar.

# .maestro/login.yml
appId: com.yourcompany.yourapp
---
- launchApp
- tapOn: "Sign in"
- tapOn:
    id: "email-input"
- inputText: "alex@example.com"
- tapOn: "Continue"
- assertVisible: "Welcome back.*"

// eas.json (excerpt)
{
  "build": {
    "e2e-test": {
      "withoutCredentials": true,
      "ios": { "simulator": true },
      "android": { "buildType": "apk" }
    }
  }
}

# .eas/workflows/e2e-test-android.yml
name: e2e-test-android
on:
  pull_request:
    branches: ["*"]
jobs:
  build_android_for_e2e:
    type: build
    params:
      platform: android
      profile: e2e-test
  maestro_test:
    needs: [build_android_for_e2e]
    type: maestro
    params:
      build_id: ${{ needs.build_android_for_e2e.outputs.build_id }}
      flow_path: [".maestro/login.yml"]

Cuándo usarlo:

Viajes de usuario críticos: login, checkout, onboarding, deep links de notificaciones push.
Flujos que cruzan chrome nativo - permisos del SO, barras de pestañas, teclados del sistema.
Compuertas de regresión antes de envío a store (complementan Mejores prácticas de pruebas).
Equipos que quieren que los no desarrolladores lean y amplíen escenarios de prueba en YAML.

Ejemplo de trabajo

Diseño del proyecto:

your-expo-app/
  .maestro/
    home.yml
    explore-collapsible.yml
  .eas/
    workflows/
      e2e-test-android.yml
      e2e-test-ios.yml
  eas.json
  app.json

// app.json (excerpt - fuente de verdad appId)
{
  "expo": {
    "name": "Tasks Demo",
    "slug": "tasks-demo",
    "ios": { "bundleIdentifier": "com.example.tasksdemo" },
    "android": { "package": "com.example.tasksdemo" }
  }
}

# .maestro/home.yml
appId: com.example.tasksdemo
---
- launchApp
- assertVisible: "Welcome!"
- tapOn: "Tasks.*"
- assertVisible: "No tasks yet"

# .maestro/explore-collapsible.yml
appId: com.example.tasksdemo
---
- launchApp
- tapOn: "Explore.*"
- tapOn: ".*File-based routing"
- assertVisible: "This app has two screens.*"
- scrollUntilVisible:
    element: "Learn more"
    direction: DOWN

// eas.json
{
  "build": {
    "e2e-test": {
      "withoutCredentials": true,
      "ios": {
        "simulator": true
      },
      "android": {
        "buildType": "apk"
      }
    }
  }
}

# .eas/workflows/e2e-test-android.yml
name: e2e-test-android
 
on:
  pull_request:
    branches: ["*"]
 
jobs:
  build_android_for_e2e:
    type: build
    params:
      platform: android
      profile: e2e-test
 
  maestro_test:
    needs: [build_android_for_e2e]
    type: maestro
    params:
      build_id: ${{ needs.build_android_for_e2e.outputs.build_id }}
      flow_path:
        - ".maestro/home.yml"
        - ".maestro/explore-collapsible.yml"

# Ejecución local (después de instalar Maestro CLI y una compilación de debug en emulador/simulador)
maestro test .maestro/home.yml
maestro test .maestro/
 
# Ejecutar EAS Workflow manualmente
npx eas-cli@latest workflow:run .eas/workflows/e2e-test-android.yml

Lo que esto demuestra:

appId coincide con android.package / ios.bundleIdentifier de app.json.
Coincidentes Regex - Tasks.* y Explore.* toleran cambios menores de etiqueta y diferencias de texto de plataforma.
Perfil de compilación e2e-test - produce .apk (Android) y simulador .app (iOS) sin credenciales de store.
Job EAS maestro - instala el artefacto de compilación desde build_id y ejecuta flujos flow_path.
Flujos independientes - cada archivo YAML es un viaje; los fallos señalan la pantalla rota.

Profundización

Cómo funciona

Maestro CLI se conecta a un emulador/simulador en ejecución (o dispositivo físico) e inicia la aplicación por appId.
Cada flujo es una lista ordenada de comandos (launchApp, tapOn, inputText, assertVisible, scrollUntilVisible, ...) ejecutados contra el árbol de UI en vivo.
Maestro usa etiquetas de accesibilidad y texto visible - agrega testID / accessibilityLabel en React Native cuando solo el texto es ambiguo.
EAS Workflows type: build produce un binario instalable; type: maestro descarga ese binario al runner y ejecuta flujos - sin carga manual de artefactos.
Los flujos son caja negra - no importan tu JS; cambiar la implementación no rompe las pruebas si la UI visible para el usuario permanece igual.

Comandos comunes de flujo

Comando	Propósito
`launchApp`	Arranque en frío (o reanudar) la aplicación bajo prueba
`tapOn`	Presiona por texto, id, o regex (`"Sign in"`, `id: "submit-btn"`)
`inputText`	Escribe en el campo enfocado
`assertVisible` / `assertNotVisible`	Falla rápido si falta el texto o id
`scrollUntilVisible`	Desplázate hasta que aparezca el elemento - listas y pantallas largas
`runFlow`	Compone subflujos para pasos de login compartidos
`extendedWaitUntil`	Espera al elemento con tiempo de espera - puertas de carga asincrónica

Opciones de integración con CI

Enfoque	Ventajas	Desventajas
Job `maestro` de EAS Workflows	Integración nativa Expo, compilación + prueba vinculadas	Requiere suscripción EAS y configuración de workflow
GitHub Actions + `maestro test`	Control total de runners	Tú administras arranque de emulador, instalación de APK y caching
`maestro test` local antes de PR	Retroalimentación más rápida	No se aplica a menos que CI también se ejecute

Expo documenta la ruta de EAS Workflows en Ejecutar pruebas E2E en EAS Workflows con Maestro.

Controles de pruebas inestables

# .maestro/checkout.yml
appId: com.example.tasksdemo
---
- launchApp
- extendedWaitUntil:
    visible: "Catalog"
    timeout: 15000
- tapOn:
    id: "product-card-1"
- assertVisible: "Add to cart"

Técnica	Cuándo
Regex (`Welcome.*`)	Pequeñas diferencias de puntuación o cadenas de plataforma
`extendedWaitUntil`	Pantallas cargadas por red, transición splash - home
`id:` / `testID`	Texto visible duplicado en pantalla
Flujos cortos y enfocados	Aísla el fallo - evita mega-flujos de 40 pasos
`runFlow` para login una vez	DRY sin fusionar aserciones no relacionadas
Cuentas de prueba estables / datos iniciales	El estado backend no debe depender de producción

Rastrea la tasa de flakes con el tiempo usando Maestro insights en EAS - reintenttos sin arreglar la causa raíz ocultan bugs de producto.

Notas de React Native

// Prefiere selectores estables que Maestro pueda dirigirse
<Pressable
  testID="sign-in-button"
  accessibilityLabel="Sign in"
  onPress={handleSignIn}
>
  <Text>Sign in</Text>
</Pressable>

- tapOn:
    id: "sign-in-button"

testID se asigna a id en Maestro - usa kebab-case consistentemente entre plataformas.
Expo Go vs cliente dev vs compilaciones de lanzamiento - appId difiere; CI debe probar el mismo tipo de binario que envías (perfil EAS e2e-test, no Expo Go).
Animaciones - espera contenido con extendedWaitUntil en lugar de comandos sleep fijos.
Teclado - inputText después de enfocar un campo; en el simulador iOS asegúrate de que el teclado de software esté habilitado para ejecuciones realistas.

Errores comunes

appId incorrecto - El flujo inicia una aplicación diferente o falla inmediatamente. Arreglo: Copia android.package / ios.bundleIdentifier de app.json después de eas build:configure, no el slug de Expo.
Pruebas en Expo Go con appId de producción - El ID de aplicación de Expo Go es host.exp.exponent, no tu ID de paquete. Arreglo: Instala una compilación EAS dev o preview en el emulador antes de maestro test.
Mega-flujos que son difíciles de depurar - Un archivo YAML cubriendo onboarding - paywall - settings oculta qué paso falló. Arreglo: Un viaje por archivo; comparte login vía runFlow.
Aserciones de cadena exacta frágiles - "Welcome" falla cuando el texto se convierte en "Welcome!" o incluye espacio final. Arreglo: Aserciones Regex (Welcome!, Welcome.*) y testID para toques críticos.
Estado backend compartido entre flujos - Los ejecutores paralelos de CI mutan el mismo usuario de prueba. Arreglo: Inquilinos de prueba dedicados, scripts iniciales idempotentes, o cuentas por ejecución.
Sin esperar contenido asincrónico - assertVisible se ejecuta antes de que se complete la búsqueda - fallos intermitentes. Arreglo: extendedWaitUntil o assertVisible después de que desaparezca un indicador de carga estable.
Asumir que Maestro reemplaza Jest - E2E es lento y no cubre cada rama. Arreglo: Mantén pruebas de unidad/componente (Jest Setup para Expo, RNTL); usa Maestro para rutas críticas delgadas.

Alternativas

Alternativa	Usar cuándo	No usar cuándo
Maestro	YAML-friendly E2E, autoría rápida, integración EAS Expo	Necesitas ganchos de sincronización nativa profunda dentro de la aplicación
Detox	Pruebas de caja gris esperando inactividad JS/nativa	El equipo quiere cero código de prueba nativo y configuración mínima
Checklist de QA manual	Pasadas exploratorias antes de lanzamientos mayores	Regresión en cada PR - no escala
RNTL + `renderRouter`	Lógica de enrutamiento sin costo de emulador	Diálogos de permiso del SO o gestos reales
Appium	Estándar empresarial de pila cruzada ya en vigor	Equipo Expo greenfield queriendo ceremonia más baja

FAQs

¿Cómo instalo Maestro localmente?

Sigue Instalar Maestro CLI. Necesitas un emulador/simulador iniciado con tu binario de aplicación instalado antes de maestro test.

¿Dónde viven los archivos de flujo?

Convención: .maestro/ en la raíz del proyecto (hermano de eas.json). Nombra flujos por viaje (login.yml, checkout-guest.yml), no por número de sprint.

¿Qué es el separador --- en flujos YAML?

Las líneas arriba de --- son configuración (appId, name opcional, env). Las líneas debajo son la lista de comandos ejecutada en orden.

¿Cómo ejecuto todos los flujos?

maestro test .maestro/

Ejecuta cada flujo en el directorio. En CI, lista rutas explícitas en flow_path para que borradores experimentales no se recojan accidentalmente.

¿Cómo sabe EAS qué binario de aplicación instalar?

El build_id del job maestro hace referencia al artefacto del job build en el mismo workflow. Compila con el perfil e2e-test para que la salida sea un .apk o simulador .app instalable.

¿Puedo ejecutar Maestro en iOS y Android en un workflow?

¿Cómo objetivo un elemento con texto duplicado?

- tapOn:
    id: "submit-button"

Agrega testID en React Native. Prefiere id sobre toques de coordenadas - las coordenadas se rompen entre tamaños de pantalla.

¿Cómo manejo spinners de carga?

- extendedWaitUntil:
    visible: "Dashboard"
    timeout: 20000

Espera la pantalla post-carga - no el spinner mismo - para que redes rápidas no hagan flake en la visibilidad del spinner.

¿Puede Maestro rellenar campos de texto seguro?

Sí - inputText funciona en campos seguros enfocados. Asegúrate de que el campo sea tocado primero. Prueba en ambas plataformas; el comportamiento del teclado difiere en el simulador iOS.

¿Cómo reutilizo una secuencia de login?

# .maestro/subflows/login.yml
- tapOn: "Sign in"
- inputText: "test@example.com"
# ...
 
# .maestro/checkout.yml
- runFlow: subflows/login.yml
- tapOn: "Checkout"

Mantén subflujos en .maestro/subflows/ y hace referencia con runFlow.

¿Qué perfil de compilación debe usar e2e-test?

withoutCredentials: true - compilaciones internas de CI sin configuración de firma de store.
Android buildType: "apk" - instalable en emulador sin danza de firma de Play.
iOS simulator: true - produce un simulador .app, no un IPA de App Store.

¿Maestro vs Detox para Expo SDK 57?

¿Cómo reduzco flakes en CI?

Fija el nivel de API del emulador en CI para que coincida con dev local.
Siembra datos backend antes de flujos.
Usa extendedWaitUntil para pantallas vinculadas a la red.
Divide flujos largos; las políticas de reintento ayudan pero arregla problemas de sincronización raíz primero.

¿Debo confirmar .maestro en git?

Sí - los flujos son código fuente. Revísalos como cambios de aplicación. Excluye la salida de debug local de Maestro o grabaciones de pantalla si tu equipo las genera durante el desarrollo.

¿Cuántos flujos E2E necesito?

Relacionado

Conceptos básicos de pruebas móviles - dónde se ubica E2E en la pirámide de pruebas
Jest Setup para Expo - pruebas rápidas de unidad que Maestro no reemplaza
React Native Testing Library - pruebas de componentes bajo E2E
Detox E2E - alternativa de caja gris cuando Maestro no es suficiente
Integración de GitHub Actions - runners de CI no EAS con Maestro
Conceptos básicos de EAS Build - perfiles de compilación que alimentan jobs E2E

Versiones de pila: Esta página fue escrita para React 19.2.3, React Native 0.86.0, y Expo SDK 57 (expo ~57.0.4).

Maestro E2E

Buscar en la documentación

Maestro E2E