ADB コマンドリファレンス¶
本端末の調査・デバッグでよく使う ADB コマンドをまとめた実用リファレンスです。
本端末は userdebug ビルドかつ su が最初から入っているため、adb root / adb remount がそのまま通ります。USB を挿すと ADB と RNDIS が自動で有効になるため、無線が死んでいても PC からは常にフルアクセスできます。
シリアル番号の指定
以下の例では -s <SERIAL> を明示していますが、端末が 1 台しか繋がっていない場合は省略できます。
1. 基本操作¶
2. ログ取得¶
# リアルタイムログ
adb logcat -v time
# ファイルへ保存
adb logcat -v time > logcat.txt
# クラッシュのみ
adb logcat -b crash
# 無線まわりのログ(セルラー調査用)
adb logcat -b radio
# カーネルログ
adb shell dmesg > dmesg.log
3. 画面操作・スクリーンショット¶
adb shell screencap -p /sdcard/screen.png
adb pull /sdcard/screen.png .
# 画面録画
adb shell screenrecord /sdcard/rec.mp4
4. アプリ・アクティビティ管理¶
# 最前面のアプリ/アクティビティ
adb shell "dumpsys window | grep -E 'mCurrentFocus|mFocusedApp'"
# サードパーティアプリ一覧
adb shell pm list packages -3
# 全パッケージ(インストールパス付き)
adb shell pm list packages -f
# APK パスの確認と取得
adb shell pm path com.hikvision.alcoholtest
adb pull /data/app/com.hikvision.alcoholtest-<hash>/base.apk ./alcoholtest.apk
# 設定画面など、ランチャーから消されている Activity を直接起動する
adb shell am start -n com.android.settings/.Settings\$WifiSettingsActivity
設定メニューが消えている件
本端末は Settings.apk から通信系メニューが削除されています。上記の am start や Activity Launcher 系アプリで直接 Activity を叩くのが定石です。詳細は Wi-Fi 恒久有効化手順 を参照してください。
5. ハードウェア・センサー状態¶
# I2C デバイス一覧(Goodix タッチ、PCF8563 RTC、AW2013 LED などが見える)
adb shell "ls -l /sys/bus/i2c/devices/"
# 入力イベントのモニタリング(物理ボタンの死活確認に有用)
adb shell getevent -lt
# GPIO の状態(ホームボタンの GPIO 88 特定に使用)
adb shell cat /sys/kernel/debug/gpio
# バッテリー状態
adb shell dumpsys battery
# ロード中カーネルモジュール
adb shell cat /proc/modules
6. シリアルポート / プリンター¶
# アルコールセンサー基板の UART
adb shell ls -l /dev/ttyMSM1
# サーマルプリンターのキャラクタデバイス
adb shell ls -l /dev/prn-dev
# 権限が足りない場合(本端末は最初から 777 のことが多い)
adb shell su -c "chmod 777 /dev/ttyMSM1 /dev/prn-dev"
プロトコルの詳細は シリアル通信プロトコル と プリンター制御仕様 を参照してください。
7. セキュリティ状態の確認¶
adb shell getenforce # -> Permissive
adb shell getprop ro.boot.veritymode # -> disabled
adb shell getprop ro.boot.verifiedbootstate # -> orange (unlocked)
adb shell getprop ro.build.type # -> userdebug
詳細な評価は セキュリティ状態 を参照してください。
8. バックアップ¶
パーティションの RAW ダンプなど、本格的なバックアップ手順は バックアップ手順 にまとめています。