萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

ADB 核心命令大全:設備管理、應用安裝、文件傳輸、日誌抓取、Shell 交互與進階調試速查表

ADB (Android Debug Bridge) 是 Android 開發、測試、運維的瑞士軍刀。本文整理 30+ 高頻核心命令,按場景分類 (設備連接、應用管理、文件同步、日誌系統、Shell 環境、系統屬性、網絡/端口、備份恢復、進階調試),附帶參數詳解、實用組合技、常見錯誤排查,桌面必備速查手冊。

一、 設備連接與狀態

adb devices [-l]                    # 列出設備 (-l 顯示產品/型號/傳輸ID)
adb devices | grep -w device        # 僅顯示在線設備
adb get-state                       # 狀態: device/offline/unknown/bootloader/recovery
adb get-serialno                    # 獲取序列號
adb get-devpath                     # 獲取 USB 設備路徑
adb wait-for-device [-t timeout]    # 等待設備在線 (腳本常用)
adb kill-server / adb start-server  # 重啟 ADB 服務
adb version                         # 版本信息
adb help                            # 幫助

二、 應用管理 (安裝/協載/清理/權限)

adb install [-r] [-d] [-g] [-t]   # 安裝 (-r覆蓋 -d降級 -g授權所有權限 -t測試包)
adb install-multiple [-r] [-d] [-g]  ... # 多 APK (分包/動態分發) 同時安裝
adb uninstall [-k]               # 協載 (-k 保留數據/緩存)
adb shell pm list packages [-f] [-d] [-e] [-3] # 列出包 (-f含路徑 -d禁用 -e啟用 -3第三方)
adb shell pm path                # 獲取 APK 路徑
adb shell pm dump                # 完整包信息 (權限、組件、簽名、安裝源)
adb shell pm grant   # 授權運行時權限 (API 23+)
adb shell pm revoke   # 撤銷權限
adb shell pm enable/disable      # 啟用/禁用應用 (需 root 或 shell 權限)
adb shell cmd package compile -m speed -f  # AOT 編譯優化 (Profile Guided)

三、 文件傳輸與同步

adb push                 # 電腦 → 手機 (目錄遞歸)
adb pull                 # 手機 → 電腦
adb sync [system|data|odm|oem]          # 同步構建輸出目錄到設備 (編譯系統用)
# 示例
adb push ./app/build/outputs/apk/debug/app-debug.apk /sdcard/Download/
adb pull /sdcard/DCIM/Camera/ ./Photos/
adb shell ls -la /sdcard/               # 遠程列目錄

四、 日誌系統 (Logcat) — 核心調試窗口

adb logcat []                   # 實時日誌
adb logcat -v brief/time/color/long     # 格式
adb logcat -b main/system/radio/events/crash/all # 緩衝區 (main主 system系統 radio無線 crash崩潰)
adb logcat -c                           # 清空緩衝區
adb logcat -d                           # 打印並退出 (非實時)
adb logcat -f  -r  -n  # 循環寫文件 (大小/個數限制)
adb logcat -G                     # 設置緩衝區大小 (如 16M)
adb logcat -T ''   # 從指定時間打印 (需配合 -d)
adb logcat --pid=                  # 過濾進程
adb logcat -s TAG:V TAG2:D *:S          # 過濾標籤 (V/D/I/W/E/F/S) *:S 靜默其它
# 經典組合
adb logcat -v color -s MyTag:D *:S      # 彩色輸出指定標籤
adb logcat -b crash -d                  # 導出崩潤日誌

五、 Shell 環境與系統交互

adb shell                             # 進入交互式 Shell (Linux 環境)
adb shell                    # 執行單條命令並退出
# 常用 Shell 子命令
adb shell dumpsys            # 系統服務狀態傾印 (battery, activity, window, package, meminfo, gfxinfo, usagestats)
adb shell dumpsys activity activities # 查看 Activity 棧/任務
adb shell dumpsys batterystats        # 電池統計 (生成 bugreport 核心)
adb shell dumpsys meminfo    # 進程內存詳情 (PSS, Private Dirty, Heap)
adb shell dumpsys gfxinfo    # 幀率/繪製性能數據
adb shell ps -A / ps -ef              # 進程列表
adb shell top -n 1 -d 1               # 實時 CPU/內存 (類 top)
adb shell kill                   # 殺進程
adb shell am start -n pkg/.Activity   # 啟動 Activity (Intent 完整支持)
adb shell am broadcast -a ACTION      # 發送廣播
adb shell am force-stop      # 強制停止應用
adb shell pm clear           # 清除應用數據 (相當卸載重裝保留 APK)
adb shell input text "string"         # 模擬輸入文本
adb shell input tap x y / swipe x1 y1 x2 y2 duration # 模擬點擊/滑動
adb shell screencap -p /sdcard/sc.png # 截圖
adb shell screenrecord /sdcard/vid.mp4 # 錄屏 (限 3分鐘/4Mbps)
adb shell settings put global   # 修改全局設置 (如 stay_on_while_plugged_in=3)
adb shell getprop / setprop           # 系統屬性讀寫 (ro.build.version.sdk 等)

六、 端口轉發與網絡調試

adb forward tcp: tcp:          # TCP 轉發 (本地:設備)
adb forward --remove tcp:              # 移除轉發
adb forward --list                            # 列出轉發
adb reverse tcp: tcp:          # 反向轉發 (設備訪問電腦服務, API 21+)
# 典型用例
adb forward tcp:8080 tcp:8080                 # 手機訪問電腦 8080 服務
adb reverse tcp:9222 tcp:9222                 # Chrome DevTools 遠程調試 WebView
adb reverse tcp:8080 tcp:8080                 # 手機 App 訪問電腦 Mock Server

七、 備份與恢復 (舊版功能,現建議用 Google One / 專項方案)

adb backup [-f ] [-apk|-noapk] [-obb|-noobb] [-shared|-noshared] [-all] [-system|-nosystem] 
adb restore 
# 現代替代:應用內導出/雲同步 / adb shell bu backup/restore (新備份框架 API 24+)

八、 進階調試與專項工具

# Systrace / Perfetto 系統級追蹤
adb shell atrace --async_start -b 32768 -c sched freq idle am wm gfx view binder_driver hal dalvik camera input res memory
# ... 操作 ...
adb shell atrace --async_stop -o trace.perfetto-trace
adb pull /data/misc/perfetto-traces/trace.perfetto-trace . # 在 UI.perfetto.dev 分析

# GPU Inspector (AGI) 圖形幀分析
adb shell setprop debug.agi.enable 1
# AGI Desktop 連接分析

# 內存分析
adb shell am dumpheap  /data/local/tmp/heap.hprof
adb pull /data/local/tmp/heap.hprof .
# 用 Android Studio Profiler / MAT / jhat 分析

# SQLite 數據庫操作
adb shell
sqlite3 /data/data/pkg/databases/db.db ".schema"
sqlite3 /data/data/pkg/databases/db.db "SELECT * FROM table;"

# SELinux 策略查看
adb shell sesearch --allow -s untrusted_app -t app_data_file -c file

九、 常見錯誤速查

錯誤原因解決
error: device unauthorized未授權 USB 調試手機彈窗點「允許」/ 撤銷授權重試
error: device offline連接斷開/ADB 服務異常adb kill-server; 插拔線; 重啟手機 ADB
cannot bind 'tcp:5037'端口被佔用殺佔用進程/改端口/關衝突軟件
INSTALL_FAILED_ALREADY_EXISTS應用已存在adb install -r (覆蓋) / 先 uninstall
INSTALL_FAILED_VERSION_DOWNGRADE版本號降級adb install -d (允許降級) / 先 uninstall
INSTALL_FAILED_TEST_ONLY測試包adb install -t
Permission denied (shell cmd)無權限 (需 root 或特定權限)root / 使用 run-as pkg / 檢查導出組件

建議將此表導出為 PDF/Markdown 置於工位,遇到問題秒級定位命令。熟練掌握 dumpsys, logcat, forward/reverse, shell am/pm 組合拳,是 Android 工程師的基本功。

copyright © 萬盛學電腦網 all rights reserved