Repolode
제출하기
mobile-dev-inc

mobile-dev-inc/Maestro

일반 YAML 플로우로 Android, iOS, 웹 앱의 UI 및 엔드투엔드 테스트를 작성하는 오픈소스 프레임워크입니다.

대체할 수 있는 제품:Appium

GitHub에서 보기웹사이트
스타
16,343
포크
1,019
열린 이슈
454
마지막 커밋
16시간 전

어떤 프로젝트인가요?

Maestro는 Android, iOS, 웹 앱의 UI 및 엔드투엔드 테스트를 작성하기 위한 오픈소스 프레임워크입니다. 테스트는 launchApp, tapOn, inputText, assertVisible 같은 YAML 명령을 나열한 간단한 형태라, 특정 테스트 SDK를 깊이 알지 못해도 플로우를 읽고 작성할 수 있습니다.

Maestro는 플랫폼의 접근성 레이어를 통해 앱을 제어하며, 드라이버나 SDK를 따로 설정하지 않고 단일 CLI 바이너리로 설치할 수 있습니다. 플로우는 컴파일하지 않고 해석하며, 내장된 대기 기능이 동적인 화면을 처리하므로 수동으로 sleep을 호출할 필요가 없습니다. 동일한 명령 구문을 React Native, Flutter, 네이티브 iOS 및 Android, Ionic, 하이브리드 앱에서 사용할 수 있으며, 에뮬레이터, 시뮬레이터, 브라우저, 실제 Android 기기에서도 실행할 수 있습니다. 실제 iOS 기기는 아직 지원하지 않습니다.

Maestro MCP 서버는 CLI에 포함되어 있어 Claude Code나 Cursor 같은 코딩 에이전트가 실제 기기를 살펴보고 앱과 상호작용하며 작업 결과를 확인할 수 있습니다. 데스크톱 시각적 테스트 빌더인 Maestro Studio는 별도 무료 다운로드로 제공되며, Maestro Cloud는 병렬 테스트 실행을 지원합니다.

핵심 기능

  • 01tapOn, assertVisible 같은 읽기 쉬운 YAML 명령으로 테스트 작성
  • 02드라이버나 SDK 없이 단일 바이너리 CLI 설치
  • 03동적 UI를 위한 자동 대기 및 불안정성 대응
  • 04Android, iOS, 웹은 물론 React Native, Flutter, 네이티브 앱에서 동일한 구문 사용
  • 05MCP 서버를 통해 코딩 에이전트가 실제 기기에서 앱을 제어하고 테스트

활용 사례

  • CI에서 실행하는 모바일 앱 엔드투엔드 회귀 테스트
  • Android 에뮬레이터에서 React Native 또는 Flutter 앱의 스모크 테스트
  • 코딩 에이전트가 커밋 전에 기기에서 UI 변경 사항을 검증하도록 하기
  • 동일한 플로우 구문을 사용하는 웹 앱 브라우저 기반 E2E 검사

빠른 시작

  1. 1

    Java 17 이상이 설치되어 있는지 확인하세요

    java -version
  2. 2

    README의 공식 설치 스크립트를 실행하세요(macOS, Linux 또는 Windows WSL)

  3. 3

    문서를 따라 Maestro CLI로 첫 테스트를 실행하세요

사용 전 알아둘 점

  • 실제 iOS 기기는 아직 지원되지 않습니다.
  • Java 17 이상이 필요합니다.
  • Maestro Studio는 무료이지만 코드는 오픈 소스가 아닙니다.

포함된 컬렉션

Android 앱 및 휴대폰 도구

토픽

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

자주 묻는 질문

Maestro은(는) 무엇인가요?
일반 YAML 플로우로 Android, iOS, 웹 앱의 UI 및 엔드투엔드 테스트를 작성하는 오픈소스 프레임워크입니다. Maestro는 Android, iOS, 웹 앱의 UI 및 엔드투엔드 테스트를 작성하기 위한 오픈소스 프레임워크입니다. 테스트는 launchApp, tapOn, inputText, assertVisible 같은 YAML 명령을 나열한 간단한 형태라, 특정 테스트 SDK를 깊이 알지 못해도 플로우를 읽고 작성할 수 있습니다.
Maestro은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
Maestro은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
Maestro은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. Maestro의 마지막 커밋은 2026년 11월 6일입니다.
Maestro은(는) 어디에 사용할 수 있나요?
CI에서 실행하는 모바일 앱 엔드투엔드 회귀 테스트 Android 에뮬레이터에서 React Native 또는 Flutter 앱의 스모크 테스트 코딩 에이전트가 커밋 전에 기기에서 UI 변경 사항을 검증하도록 하기 동일한 플로우 구문을 사용하는 웹 앱 브라우저 기반 E2E 검사
Maestro는 어떻게 설치하나요?
Java 17 이상이 설치되어 있는지 확인하세요: java -version README의 공식 설치 스크립트를 실행하세요(macOS, Linux 또는 Windows WSL) 문서를 따라 Maestro CLI로 첫 테스트를 실행하세요
Maestro은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/mobile-dev-inc/Maestro

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트