Repolode
mobile-dev-inc

mobile-dev-inc/Maestro

Framework de código abierto para pruebas de UI y end-to-end de apps para Android, iOS y web mediante flujos YAML sencillos.

Alternativa open source a:Appium

Estrellas
16,347
Forks
1,019
Issues abiertos
454
Último commit
hace 23 horas

¿Qué es?

Maestro es un framework de código abierto para escribir pruebas de UI y end-to-end de apps para Android, iOS y web. Las pruebas son listas planas de comandos YAML, como launchApp, tapOn, inputText y assertVisible, de modo que se pueden leer y escribir flujos sin conocer a fondo un SDK de pruebas específico.

Maestro controla las apps a través de la capa de accesibilidad de la plataforma y se instala como un único binario CLI, sin necesidad de configurar drivers ni SDK. Los flujos se interpretan en lugar de compilarse, y la espera integrada permite manejar pantallas dinámicas sin llamadas manuales a sleep. La misma sintaxis de comandos funciona con React Native, Flutter, apps nativas de iOS y Android, Ionic y apps híbridas, en emuladores, simuladores, navegadores y dispositivos Android físicos. Los dispositivos iOS físicos todavía no son compatibles.

El servidor MCP de Maestro viene incluido en la CLI y permite que agentes de programación como Claude Code o Cursor inspeccionen un dispositivo activo, interactúen con la app y verifiquen su propio trabajo. Maestro Studio, un creador visual de pruebas para escritorio, está disponible como descarga gratuita independiente, y Maestro Cloud ofrece ejecución de pruebas en paralelo.

Funciones clave

  • 01Pruebas escritas con comandos YAML fáciles de leer, como tapOn y assertVisible
  • 02Instalación de la CLI como un único binario, sin necesidad de drivers ni SDK
  • 03Espera automática y tolerancia a fallos intermitentes en interfaces dinámicas
  • 04Una sintaxis para Android, iOS y web, así como para apps de React Native, Flutter y nativas
  • 05El servidor MCP permite que agentes de programación controlen y prueben apps en un dispositivo activo

Casos de uso

  • Pruebas de regresión end-to-end de una app móvil ejecutadas en CI
  • Pruebas smoke de una app de React Native o Flutter en emuladores Android
  • Permitir que un agente de programación verifique un cambio de UI en un dispositivo antes de hacer commit
  • Pruebas E2E en navegador para una app web con la misma sintaxis de flujos

Inicio rápido

  1. 1

    Comprueba que Java 17 o una versión posterior esté instalado

    java -version
  2. 2

    Ejecuta el script oficial de instalación del README (macOS, Linux o Windows WSL)

  3. 3

    Sigue la documentación para ejecutar tu primera prueba con Maestro CLI

Antes de usarlo

  • Los dispositivos iOS físicos aún no son compatibles.
  • Se requiere Java 17 o una versión posterior.
  • Maestro Studio es gratuito, pero su código no es de código abierto.

En colecciones

Temas

Preguntas frecuentes

¿Qué es Maestro?
Framework de código abierto para pruebas de UI y end-to-end de apps para Android, iOS y web mediante flujos YAML sencillos. Maestro es un framework de código abierto para escribir pruebas de UI y end-to-end de apps para Android, iOS y web. Las pruebas son listas planas de comandos YAML, como launchApp, tapOn, inputText y assertVisible, de modo que se pueden leer y escribir flujos sin conocer a fondo un SDK de pruebas específico.
¿Maestro es gratuito? ¿Qué licencia tiene?
Maestro es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿Maestro sigue mantenido?
Mantenimiento activo. El último commit de Maestro fue el 6 nov 2026.
¿Para qué puedo usar Maestro?
Pruebas de regresión end-to-end de una app móvil ejecutadas en CI Pruebas smoke de una app de React Native o Flutter en emuladores Android Permitir que un agente de programación verifique un cambio de UI en un dispositivo antes de hacer commit Pruebas E2E en navegador para una app web con la misma sintaxis de flujos
¿Cómo se instala Maestro?
Comprueba que Java 17 o una versión posterior esté instalado: java -version Ejecuta el script oficial de instalación del README (macOS, Linux o Windows WSL) Sigue la documentación para ejecutar tu primera prueba con Maestro CLI
¿Dónde consigo Maestro?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/mobile-dev-inc/Maestro

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados