ADB (Android Debug Bridge) 是 Android 開發與測試的核心命令列工具。掌握高頻指令可大幅提升除錯與自動化效率。
adb devices # 列出已連接裝置/模擬器
adb kill-server && adb start-server # 重啟 ADB 服務
adb wait-for-device # 等待裝置上線(腳本常用)
adb install -r app.apk # -r 覆蓋安裝保留資料
adb install -s app.apk # -s 安裝至 SD 卡
adb uninstall -k com.pkg # -k 保留資料與快取目錄
adb push local.txt /sdcard/remote.txt # 電腦 → 裝置
adb pull /sdcard/remote.txt local.txt # 裝置 → 電腦
adb sync [system|data] # 僅同步有變更檔案(需 root remount)
adb shell # 進入互動式 Shell
adb shell # 執行單條命令
adb shell logcat # 即時日誌(可加過濾標籤)
adb shell dumpsys # 系統服務狀態傾印
adb shell pm list packages # 列出已安裝套件
adb shell am start -n pkg/.Activity # 啟動 Activity
adb shell am force-stop pkg # 強制停止應用
adb forward tcp:8888 tcp:8888 # TCP 埠轉發
adb forward localabstract:my_socket # Unix domain socket
adb tcpip 5555 # 切換至 TCP/IP 模式(無線調試)
adb connect 192.168.1.100:5555 # 連接無線裝置
adb reboot [bootloader|recovery] # 重啟/進入 Bootloader/Recovery
adb reboot-bootloader # 直接進入 Bootloader
adb root # 以 root 身分重啟 adbd (需 userdebug/eng 版本)
adb remount # 重掛載 /system 為可寫 (需 root)
adb logcat -s TAG:V # 依標籤過濾日誌等級
adb bugreport > bugreport.txt # 完整錯誤報告(含 dumpsys、logcat、事件日誌)
adb jdwp # 列出 JDWP 進程 ID(供 jdb/IDE 連接除錯)
ANDROID_SERIAL:指定目標裝置序號(-s 參數優先級更高);ADB_TRACE=1,adb,sockets,usb:開啟 ADB 內部除錯日誌;ANDROID_LOG_TAGS:限制 logcat 輸出標籤。-s <serial> 指定目標;adb shell screencap -p /sdcard/screen.png && adb pull /sdcard/screen.png 一鍵截圖;adb shell screenrecord /sdcard/demo.mp4 錄製螢幕影片;grep/awk 處理日誌:adb logcat | grep -i exception。