mcpField
P
patrol-setup

patrol-setup

github.com/leancodeplテスト・品質1.5k295 回インストール今日更新
リポジトリ

patrol-setup について

Android エミュレーターで最初の Patrol テストを動かすためのセットアップスキルです。ネイティブ設定、単独で完結するテスト、生成ファイルの除外、よくある問題を扱い、初期範囲に iOS は含みません。

主な機能

  1. 01Patrol の依存関係と Android 設定
  2. 02最小限の自己完結型テスト
  3. 03生成ファイルと秘密情報の除外
  4. 04エミュレーター実行とトラブルシューティング

活用シーン

  1. 01Flutter プロジェクトでの Patrol 設定
  2. 02Android でのテストハーネス検証
  3. 03MainActivity や flavor 設定エラーの診断

MCP 対応

任意の次の手順として Patrol MCP を紹介し、エージェントによるテスト実行、スクリーンショット取得、ネイティブ UI ツリー確認、対話セッション操作に触れています。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/leancodepl/patrol --skill patrol-setup

インストール後、Claude Code で/patrol-setupを入力して読み込まれたか確認します。

詳細

Patrol のセットアップ

Android エミュレーターで最初の Patrol テストを成功させます。最初に、これはAndroid のみを対象としていること（pubspec の patrol: ブロック＋ネイティブ Android）をユーザーに伝えてください。iOS やその他のプラットフォームも同じインストール手順に従いますが、この初回セットアップには含まれません。

このスキルでは、手順の順序と注意点を説明します。バージョン、ネイティブ設定、コードについては公式ドキュメントが正とされる情報源です。推測せず、各ステップで公式ドキュメントに従ってください。

1. Patrol を設定する

該当箇所へのディープリンクを使用しながら、セットアップの手順に従ってください。

2. 最初のシンプルなテストを書く

現在の API に対応した最初のテストを書くの手順に従ってください。 https://patrol.leancode.co/documentation/write-your-first-test

最初のテストは単独で完結するものにしてください。Flutter フレームワークのウィジェットのみを使用し、アプリやバックエンドには依存させません。そうすることで、テストが成功すればハーネス自体が機能していると確認できます。patrol_test/（または設定済みの test_directory）に配置してください。

3. バンドルとシークレットを除外する

セットアップのセクションに従い、test_bundle.dart（Patrol が生成）と .patrol.env（dart-defines。多くの場合シークレットを含みます）を Git の無視対象に追加してください。 https://patrol.leancode.co/documentation#setup

4. エミュレーターで実行する

Android エミュレーターを起動し、実行前に起動が完全に完了するまで待ってください。起動中にテストを開始すると失敗します。その後、patrol test を使って単一のテストを実行します。テストが成功すればセットアップは完了です。

注意点

  • （Java）MainActivity を解決できない — MainActivityTest.java の package をアプリの applicationId に設定してください。
  • その他のエラー（バンドルのビルド失敗、ハング、フレーバーの不一致など）— ドキュメントの FAQ を参照してください：https://patrol.leancode.co/documentation#faq

次のステップ：Patrol MCP（任意）

セットアップが成功したら、Patrol MCP が利用可能で、希望に応じてセットアップできることをユーザーに伝えてください。Patrol MCP を使うと、AI エージェントがテストの実行、スクリーンショットの撮影、ネイティブ UI ツリーの読み取り、インタラクティブなセッションの操作を行えます。導入するかどうかはユーザーに判断してもらい、希望する場合は README に従ってください：https://pub.dev/packages/patrol_mcp

コメント

Markdown 対応