Android ADB

raw adb コマンドで Android デバイスを制御するためのリファレンスです。

実行時の制約

• 複数のデバイスが接続されている場合は、常に adb -s <serial> を使用します。
• 座標操作の前にスクリーン解像度を確認します: adb -s SERIAL shell wm size
• 実行前に必要な入力情報（serial、package/activity、座標、APK パス）が不足していないか確認してください。
• 失敗時にはアクション可能な stderr を表示します（認可、ケーブル/ネットワーク、tcpip 状態）。
• ADB Keyboard がインストールされている場合は、CJK および特殊文字入力に対して ADB Keyboard ブロードキャストを優先します。

デバイスとサーバー

# ADB サーバーを起動
adb start-server

# ADB サーバーを停止
adb kill-server

# デバイス一覧
adb devices -l

# 特定のデバイスをターゲット（複数デバイスがオンライン時に使用）
adb -s SERIAL <command>

Wi-Fi 接続

# tcpip を有効化（USB 接続が必須）
adb -s SERIAL tcpip 5555

# デバイスの IP を取得
adb -s SERIAL shell ip route | grep src
# または
adb -s SERIAL shell ip addr show wlan0

# ネットワーク経由で接続
adb connect <ip>:5555

# 接続解除
adb disconnect <ip>:5555

デバイス状態

# スクリーン サイズ
adb -s SERIAL shell wm size

# 現在のフォーカス中のアプリ（mCurrentFocus から取得）
adb -s SERIAL shell dumpsys window | grep -E 'mCurrentFocus|mFocusedApp'

# ホーム ランチャー パッケージを取得（ホーム画面検出用）
adb -s SERIAL shell cmd package resolve-activity --brief -c android.intent.category.HOME

# raw shell コマンド
adb -s SERIAL shell <command>

アプリのライフサイクル

# パッケージがインストールされているか確認
adb -s SERIAL shell pm list packages | grep <package>

# パッケージ名で起動（monkey 経由）
adb -s SERIAL shell monkey -p <package> -c android.intent.category.LAUNCHER 1

# アクティビティ名で起動
adb -s SERIAL shell am start -W -n <package>/<activity>

# URI/スキーム で起動
adb -s SERIAL shell am start -W -a android.intent.action.VIEW -d "<scheme://path>"

# 強制停止
adb -s SERIAL shell am force-stop <package>

入力アクション

# タップ
adb -s SERIAL shell input tap X Y

# ダブルタップ（短い遅延で 2 回タップ）
adb -s SERIAL shell input tap X Y && sleep 0.1 && adb -s SERIAL shell input tap X Y

# 長押し（同じ点へスワイプして duration を設定）
adb -s SERIAL shell input swipe X Y X Y 3000

# スワイプ
adb -s SERIAL shell input swipe X1 Y1 X2 Y2 [duration_ms]

# キーイベント
adb -s SERIAL shell input keyevent KEYCODE_BACK
adb -s SERIAL shell input keyevent KEYCODE_HOME
adb -s SERIAL shell input keyevent KEYCODE_ENTER

# ホームに戻る（BACK を何度も押して、フォーカスをホーム ランチャーと比較）
for i in $(seq 1 20); do
  adb -s SERIAL shell input keyevent KEYCODE_BACK
  sleep 0.5
  # 現在のフォーカスをホーム パッケージと比較してホーム画面に到達したか確認
  CURRENT=$(adb -s SERIAL shell dumpsys window | grep mCurrentFocus)
  echo "Round $i: $CURRENT"
done

テキスト入力

# プレーンテキスト入力（ASCII のみ、スペースは %s でエスケープ）
adb -s SERIAL shell input text "hello%sworld"

# ADB Keyboard 経由のテキスト入力（CJK および特殊文字に対応）
# まず ADB Keyboard がアクティブであることを確認します：
adb -s SERIAL shell ime set com.android.adbkeyboard/.AdbIME
# その後、テキストを送信します（base64 エンコード）：
adb -s SERIAL shell am broadcast -a ADB_INPUT_B64 --es msg "$(echo -n 'your text' | base64)"

# ADB Keyboard経由でテキストをクリア
adb -s SERIAL shell am broadcast -a ADB_CLEAR_TEXT

スクリーンショットと UI ツリー

# ローカル ファイルにスクリーンショットを取得
adb -s SERIAL exec-out screencap -p > screenshot.png

# デバイスにスクリーンショットを取得して pull
adb -s SERIAL shell screencap -p /sdcard/screen.png
adb -s SERIAL pull /sdcard/screen.png ./screen.png

# UI 階層の XML をダンプ
adb -s SERIAL shell uiautomator dump /sdcard/window_dump.xml
adb -s SERIAL pull /sdcard/window_dump.xml ./window_dump.xml

アプリのインストールとアンインストール

# APK をインストール（既存のものを置き換え）
adb -s SERIAL install -r /path/to/app.apk

# アンインストール
adb -s SERIAL uninstall <package>

よく使うキーコード

キーコード	説明
KEYCODE_BACK	戻るボタン
KEYCODE_HOME	ホーム ボタン
KEYCODE_ENTER	Enter/確定
KEYCODE_DEL	削除/バックスペース
KEYCODE_VOLUME_UP	音量アップ
KEYCODE_VOLUME_DOWN	音量ダウン
KEYCODE_POWER	電源ボタン
KEYCODE_TAB	Tab キー
KEYCODE_ESCAPE	Escape キー