ADB安裝使用指南

ADB安裝使用指南

本文介紹 ADB（Android Debug Bridge）在 Windows / macOS / Linux 的安裝、設定與常用操作，適用於真機與雲機連線場景。

ADB 是什麼

ADB 是 Android 官方提供的除錯橋接工具，可用於裝置連線、應用安裝、日誌查看、檔案傳輸與連接埠轉發。

核心組成：

1. Client（用戶端）：你在終端執行的 adb 指令。

2. Server（服務端）：本機背景行程，預設監聽 5037。

3. Daemon（adbd）：執行於 Android 裝置上的守護行程。

安裝前準備

1. 確保終端可連外網以下載 Android SDK Platform-Tools。

2. 建議優先使用官方 platform-tools。

3. 連接真機時，請先開啟 開發人員選項 與 USB 偵錯。

Windows 安裝

1. 下載並解壓 Platform-Tools（建議 C:\platform-tools）。

2. 將 C:\platform-tools 加入系統 Path。

3. 在 PowerShell / CMD 執行 adb version，顯示版本即成功。

4. 首次 USB 連線時，手機端請允許 USB 偵錯授權。

macOS 安裝

1. 推薦：brew install android-platform-tools

2. 或手動下載官方壓縮包並加入 PATH。

3. 驗證：adb version

Linux 安裝

1. Ubuntu / Debian：sudo apt update && sudo apt install -y android-sdk-platform-tools

2. CentOS / RHEL 建議手動安裝官方 platform-tools。

3. 驗證：adb version

首次連線與驗證

1. adb start-server

2. adb devices

3. 狀態：device 可用；unauthorized 未授權；offline 連線異常。

無線與遠端連線

局域網示例：adb connect 192.168.1.10:5555

SSH 隧道雲機示例：

1. ssh user@host -p 1824 -L 8767:adb-proxy:53398 -Nf

2. adb connect localhost:8767

常用指令

1. adb devices -l

2. adb shell

3. adb install app.apk

4. adb install -r app.apk

5. adb uninstall 套件名

6. adb logcat

7. adb push 本地檔案 /sdcard/

8. adb pull /sdcard/檔案 本地目錄

9. adb forward tcp:7001 tcp:7001

10. adb disconnect

多裝置操作

多台裝置同時在線時請使用 -s 指定序號。

常見問題排查

1. command not found：檢查安裝與 Path。

2. unauthorized：裝置端重新授權。

3. offline：重新連線並檢查網路。

4. 埠被占用：更換本地埠（如 8768）。

使用建議

1. 自動化環境固定 ADB 版本。

2. 多裝置腳本務必帶 -s。

3. 雲機建議走 SSH 隧道。

注意：請僅在你有授權管理的裝置上使用 ADB。