/mobile-automation

name: mobile-automation
description: FlutterアプリのUI動作をシミュレーター・エミュレーター・実機で検証する、BridgeとのE2Eを確認する、または権限ダイアログ等のネイティブUIを操作するときに使う。

Mobile Automation

検証対象に応じて必要な参照だけ読む。Flutter画面は dart-mcp / Marionette（debug・profile）、権限ダイアログなどのネイティブUIは agent-device で操作する。

• 起動・接続・profile起動・CLIとMCPの使い分け: [references/startup.md](references/startup.md)
• 権限ダイアログ・システムアラート・回転などのネイティブUI: [references/agent-device.md](references/agent-device.md)
• Bridge不要のMock UI検証と要素キー: [references/mock-and-keys.md](references/mock-and-keys.md)
• 実際のBridge通信を含む検証: [references/e2e.md](references/e2e.md)
• 接続・ジェスチャー・モック制限の問題: [references/troubleshooting.md](references/troubleshooting.md)

実行範囲

• 既定はiOSシミュレーターとテスト用Bridge `8766`。ユーザーが指定したデバイス・接続先を優先する。本番 `8765` のプロセスを停止しない。
• プロジェクトルートは `git rev-parse --show-toplevel`、アプリはその配下の `apps/mobile`。
• 検証する挙動と期待結果を決め、関連するシナリオを選ぶ。単純なUI確認は直接操作する。複数画面の独立した検証は、利用可能なら `e2e-verifier` 等へ委譲できる。
• 操作には現在の `get_interactive_elements` のキー・boundsを使う。画面遷移やジェスチャー後は結果を確認する。
• 要素・ログで挙動を確認し、外観・レイアウトの変更はスクリーンショットで目視する。枚数は検証対象に応じて選ぶ。
• 終了時は自分が起動したアプリ・BridgeだけPIDを指定して停止する。プレビュー継続を依頼されている場合は残し、接続方法を報告する。
• 検証結果と未確認の範囲を報告する。Mock表示の成功を実通信の成功として扱わない。