Repolode
Enviar
mobile-dev-inc

mobile-dev-inc/Maestro

Framework open source para testes de UI e end-to-end em apps Android, iOS e web usando fluxos simples em YAML.

Alternativa open source a:Appium

Ver no GitHubSite
Estrelas
16,343
Forks
1,019
Issues abertas
454
Último commit
ontem

O que é?

Maestro é um framework open source para criar testes de UI e end-to-end em apps Android, iOS e web. Os testes são listas simples de comandos YAML, como launchApp, tapOn, inputText e assertVisible, então é possível ler e escrever um fluxo sem conhecer a fundo um SDK de testes específico.

Maestro controla os apps pela camada de acessibilidade da plataforma e é instalado como um único binário CLI, sem precisar configurar drivers ou SDK. Os fluxos são interpretados, não compilados, e a espera integrada lida com telas dinâmicas sem chamadas manuais a sleep. A mesma sintaxe de comandos funciona com React Native, Flutter, apps nativos para iOS e Android, Ionic e apps híbridos, em emuladores, simuladores, navegadores e dispositivos Android físicos. Dispositivos iOS físicos ainda não são compatíveis.

O servidor MCP do Maestro vem integrado ao CLI e permite que agentes de programação, como Claude Code ou Cursor, inspecionem um dispositivo em uso, interajam com o app e verifiquem o próprio trabalho. Maestro Studio, um criador visual de testes para desktop, está disponível como download separado e gratuito, e o Maestro Cloud oferece execução paralela de testes.

Recursos principais

  • 01Testes escritos como comandos YAML fáceis de ler, como tapOn e assertVisible
  • 02Instalação do CLI como binário único, sem necessidade de drivers ou SDK
  • 03Espera automática e tolerância a instabilidades em UIs dinâmicas
  • 04Uma única sintaxe para Android, iOS, web, React Native, Flutter e apps nativos
  • 05O servidor MCP permite que agentes de programação controlem e testem apps em um dispositivo em uso

Casos de uso

  • Testes de regressão end-to-end de um app mobile executados em CI
  • Smoke tests de um app React Native ou Flutter em emuladores Android
  • Permitir que um agente de programação verifique uma alteração na UI em um dispositivo antes de fazer o commit
  • Verificações E2E de um app web no navegador usando a mesma sintaxe de fluxo

Início rápido

  1. 1

    Verifique se o Java 17 ou superior está instalado

    java -version
  2. 2

    Execute o script oficial de instalação do README (macOS, Linux ou Windows WSL)

  3. 3

    Siga a documentação para executar seu primeiro teste com o Maestro CLI

Antes de usar

  • Dispositivos iOS físicos ainda não são compatíveis.
  • É necessário ter o Java 17 ou superior.
  • O Maestro Studio é gratuito, mas seu código não é de código aberto.

Em coleções

Apps para Android e ferramentas para celular

Tópicos

#mobile-testing#e2e-testing#ui-automation#android#ios#yaml#testing-framework#blackbox-testing

Perguntas frequentes

O que é Maestro?
Framework open source para testes de UI e end-to-end em apps Android, iOS e web usando fluxos simples em YAML. Maestro é um framework open source para criar testes de UI e end-to-end em apps Android, iOS e web. Os testes são listas simples de comandos YAML, como launchApp, tapOn, inputText e assertVisible, então é possível ler e escrever um fluxo sem conhecer a fundo um SDK de testes específico.
Maestro é gratuito? Qual é a licença?
Maestro é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
Maestro ainda é mantido?
Manutenção ativa. O último commit de Maestro foi em 6 de nov. de 2026.
Para que posso usar Maestro?
Testes de regressão end-to-end de um app mobile executados em CI Smoke tests de um app React Native ou Flutter em emuladores Android Permitir que um agente de programação verifique uma alteração na UI em um dispositivo antes de fazer o commit Verificações E2E de um app web no navegador usando a mesma sintaxe de fluxo
Como instalar Maestro?
Verifique se o Java 17 ou superior está instalado: java -version Execute o script oficial de instalação do README (macOS, Linux ou Windows WSL) Siga a documentação para executar seu primeiro teste com o Maestro CLI
Onde consigo Maestro?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/mobile-dev-inc/Maestro

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados