Repolode
mobile-dev-inc

mobile-dev-inc/Maestro

YAMLのフローでAndroid、iOS、WebアプリのUIテストとE2Eテストを書けるオープンソースフレームワーク。

代替できる製品:Appium

スター
16,347
フォーク
1,019
未解決の Issue
454
最終コミット
21 時間前

これは何?

Maestroは、Android、iOS、WebアプリのUIテストやE2Eテストを作成するためのオープンソースフレームワークです。テストはlaunchApp、tapOn、inputText、assertVisibleなどのYAMLコマンドを並べたシンプルな構成なので、特定のテストSDKについて深く知らなくてもフローを読み書きできます。

Maestroはプラットフォームのアクセシビリティレイヤーを通じてアプリを操作します。ドライバーやSDKのセットアップは不要で、単一のCLIバイナリをインストールするだけで使えます。フローはコンパイルせずに解釈実行され、組み込みの待機処理によって、手動でsleepを呼び出さなくても動的な画面に対応します。同じコマンド構文をReact Native、Flutter、ネイティブのiOS・Android、Ionic、ハイブリッドアプリで利用でき、エミュレーター、シミュレーター、ブラウザー、実機のAndroidデバイスに対応しています。実機のiOSデバイスにはまだ対応していません。

Maestro MCP serverはCLIに組み込まれており、Claude CodeやCursorなどのコーディングエージェントが実機の状態を確認し、アプリを操作して、自分の変更を検証できます。デスクトップ向けのビジュアルテストビルダーMaestro Studioは、別途無料でダウンロードできます。また、Maestro Cloudではテストを並列実行できます。

主な機能

  • 01tapOnやassertVisibleのような読みやすいYAMLコマンドでテストを記述
  • 02ドライバーやSDK不要で、単一バイナリのCLIをインストール
  • 03動的なUIに対する自動待機とフレークへの耐性
  • 04Android、iOS、Webに加え、React Native、Flutter、ネイティブアプリでも共通の構文を使用
  • 05MCP serverを使って、コーディングエージェントが実機上のアプリを操作・テスト

ユースケース

  • CIで実行するモバイルアプリのE2E回帰テスト
  • Androidエミュレーター上で実行するReact NativeまたはFlutterアプリのスモークテスト
  • コミット前にコーディングエージェントに実機でUI変更を検証させる
  • 同じフロー構文を使ったWebアプリのブラウザベースのE2Eチェック

クイックスタート

  1. 1

    Java 17 以降がインストールされていることを確認してください

    java -version
  2. 2

    README に記載されている公式インストールスクリプトを実行してください(macOS、Linux、または Windows WSL)

  3. 3

    ドキュメントに従って、Maestro CLI で最初のテストを実行してください

使う前に知っておきたいこと

  • 物理 iOS デバイスはまだサポートされていません。
  • Java 17 以降が必要です。
  • Maestro Studio は無料ですが、コードはオープンソースではありません。

収録されている特集

トピック

よくある質問

Maestro とは?
YAMLのフローでAndroid、iOS、WebアプリのUIテストとE2Eテストを書けるオープンソースフレームワーク。 Maestroは、Android、iOS、WebアプリのUIテストやE2Eテストを作成するためのオープンソースフレームワークです。テストはlaunchApp、tapOn、inputText、assertVisibleなどのYAMLコマンドを並べたシンプルな構成なので、特定のテストSDKについて深く知らなくてもフローを読み書きできます。
Maestro は無料で使えますか?ライセンスは?
Maestro は Apache-2.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
Maestro は今もメンテナンスされていますか?
活発にメンテナンス中。Maestro の最終コミットは 2026年11月6日 です。
Maestro は何に使えますか?
CIで実行するモバイルアプリのE2E回帰テスト Androidエミュレーター上で実行するReact NativeまたはFlutterアプリのスモークテスト コミット前にコーディングエージェントに実機でUI変更を検証させる 同じフロー構文を使ったWebアプリのブラウザベースの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 の数値は毎日更新されます。

関連プロジェクト