Android Emulator Skill

アクセシビリティ駆動のナビゲーションと構造化データを使用して、ピクセル座標の代わりに Android アプリケーションをビルド、テスト、自動化します。

クイックスタート

# 1. 環境を確認 (macOS/Linux では .sh、Windows では .ps1 を使用)
bash scripts/emu_health_check.sh
# または Windows: .\scripts\emu_health_check.ps1

# 2. アプリを起動
python scripts/app_launcher.py --launch com.example.app

# 3. 画面をマップして要素を表示
python scripts/screen_mapper.py

# 4. ボタンをタップ
python scripts/navigator.py --find-text "Login" --tap

# 5. テキストを入力
python scripts/navigator.py --find-type EditText --enter-text "user@example.com"

すべてのスクリプトは --help で詳細なオプションを、--json でマシン可読出力をサポートしています。

プロダクションスクリプト

ビルド・開発

1. build_and_test.py - Android プロジェクトをビルド、テストを実行、結果を解析

   • Gradle のラッパー
   • assemble、install、connectedCheck のサポート
   • ビルドエラーとテスト結果を解析
   • オプション: --task、--clean、--json

2. log_monitor.py - インテリジェントなフィルタリング機能付きのリアルタイムログ監視

   • adb logcat のラッパー
   • タグ、優先度、PID でフィルタリング
   • 重複メッセージを削除
   • オプション: --package、--tag、--priority、--duration、--json

ナビゲーション・インタラクション

3. screen_mapper.py - 現在の画面を分析し、インタラクティブな要素をリストアップ

   • uiautomator を使用して UI 階層をダンプ
   • XML を解析してボタン、テキストフィールドなどを特定
   • オプション: --verbose、--json

4. navigator.py - セマンティックに要素を検出してインタラクト

   • テキスト（ファジィマッチング）、resource-id、クラス名で検出
   • インタラクティブなタップとテキスト入力
   • オプション: --find-text、--find-id、--tap、--enter-text、--json

5. gesture.py - スワイプ、スクロール、その他のジェスチャを実行

   • 上下左右へのスワイプ
   • リストのスクロール
   • オプション: --swipe、--scroll、--duration、--json

6. keyboard.py - キーイベントとハードウェアボタン

   • キーイベント (Home、Back、Enter、Tab) を入力
   • ADB 経由でテキストを入力
   • オプション: --key、--text、--json

7. app_launcher.py - アプリのライフサイクル管理

   • アプリを起動 (adb shell am start)
   • アプリを終了 (adb shell am force-stop)
   • APK のインストール/アンインストール
   • インストール済みパッケージをリスト表示
   • オプション: --launch、--terminate、--install、--uninstall、--list、--json

エミュレーターのライフサイクル管理

8. emulator_manage.py - Android Virtual Devices (AVDs) を管理

   • 利用可能な AVD をリスト表示
   • エミュレーターをブート
   • エミュレーターをシャットダウン
   • オプション: --list、--boot、--shutdown、--json

9. emu_health_check - 環境が適切に構成されていることを確認

   • macOS/Linux では emu_health_check.sh、Windows では emu_health_check.ps1 を使用
   • ADB、Emulator、Java、Gradle、ANDROID_HOME をチェック
   • 接続されたデバイスをリスト表示

一般的なパターン

自動デバイス検出: 1 つのデバイス/エミュレーターのみが接続されている場合、スクリプトはそれをターゲットにします。複数接続されている場合は -s <serial> が必要です。

出力形式: デフォルトは簡潔な人間可読形式です。マシン可読出力には --json を使用します。

要件

• Android SDK Platform-Tools (adb、fastboot)
• Android Emulator
• Java / OpenJDK
• Python 3

主要な設計原則

セマンティックナビゲーション: テキスト、resource-id、または content-description で要素を検出します。

トークン効率: デフォルトは簡潔な出力で、詳細表示と JSON モードはオプションです。

ゼロコンフィギュレーション: 標準 Android SDK インストールで動作します。