I.總體概述
Android 調(diào)試橋(ADB)用于:
- 跟蹤所有連接的或運行于給定開發(fā)者主機上的 Android 設(shè)備和模擬器實例。
- 為客戶端(命令行用戶,或像 DDMS 這樣的輔助程序)實現(xiàn)各種控制命令(比如,"adb shell","adb pull",等等)。這些命令在 ADB 中稱為 'service'。
總的來說,一切工作通過以下組件完成:
- ADB server
這是一個運行于主機上的后臺進程。它的目的是為了感知USB端口,以了解何時連接/移除設(shè)備,以及模擬器實例何時啟動/停止。
它必須維護一個 “已連接設(shè)備” 列表并為它們中的每一個分配一個 ‘狀態(tài)’:OFFLINE,BOOTLOADER,RECOVERY 或 ONLINE(下面還有更多)。
ADB server 真的是一個巨大的多路復(fù)用循環(huán),它的目的是編排客戶端,服務(wù)和設(shè)備之間的數(shù)據(jù)(包,真正的)交換。
- ADB 守護進程(adbd)
'adbd' 作為 Android 設(shè)備或模擬器系統(tǒng)內(nèi)的后臺進程運行。它的目的是連接 ADB server(對于設(shè)備來說是通過 USB,對于模擬器來說是通過 TCP)并為運行在主機上的客戶端提供一些服務(wù)。
當(dāng) ADB server 已經(jīng)成功地連接到設(shè)備內(nèi)部的 adbd 時,它才認為設(shè)備是 ONLINE 的。否則,設(shè)備是 OFFLINE 的,這意味著 ADB server 探測到了一個新的設(shè)備/模擬器,但無法連接到 adbd 守護進程。
BOOTLOADER 和 RECOVERY 狀態(tài)對應(yīng)于處在 bootloader 或 recovery 模式下的設(shè)備相應(yīng)的狀態(tài)。
- ADB 命令行客戶端
'adb' 命令行程序用于在 shell 或腳本中運行 adb 命令。它首先嘗試定位主機上的 ADB server,如果沒有它將會自動地啟動一個。
然后,客戶端給 ADB server 發(fā)送它的服務(wù)請求。它無需知道。
當(dāng)前,一個單獨的 'adb' 二進制文件同時被用作服務(wù)器和客戶端。這使得分發(fā)和啟動服務(wù)器更簡單。
- 服務(wù)
基本上有兩種客戶端可以與之交互的服務(wù)。
Host 服務(wù):
- 這些服務(wù)運行于 ADB server 內(nèi),且一點也不需要與設(shè)備通信。一個典型的例子是 "adb devices",它被用于返回當(dāng)前已知的設(shè)備和它們的狀態(tài)的列表。盡管如此,他們還是一些其他的服務(wù)。
Local 服務(wù):
這些服務(wù)或者運行于 adbd 守護進程內(nèi),或者由它在設(shè)備上啟動。ADB server 用于在客戶端和運行于 adbd 內(nèi)的服務(wù)間多路復(fù)用流。在這種情況下,它的角色是初始化連接,然后作為一個數(shù)據(jù)通道。
II. 協(xié)議細節(jié)
1. 客戶端 <-> 服務(wù)器協(xié)議
這里詳述 ADB 客戶端和 ADB server 本身之間使用的協(xié)議。ADB server 監(jiān)聽在 TCP:localhost:5037 上。
客戶端使用如下的格式發(fā)送一個請求:
- 給出了有效載荷長度的 4 字節(jié)十六進制字符串
- 然后是載荷本身。
比如,要向 ADB server 查詢它內(nèi)部的版本號,客戶端將執(zhí)行如下動作:
- 連接 tcp:localhost:5037
- 向?qū)?yīng)的 socket 發(fā)送字符串 "000Chost:version"。
'host:' 前綴用于表示請求發(fā)往服務(wù)器本身(我們稍后將討論其它種類的請求)。內(nèi)容長度以 ASCII 編碼,以方便調(diào)試。
服務(wù)器應(yīng)該以如下幾種方式之一響應(yīng)一個請求:
- 請求成功:4 字節(jié)的 "OKAY" 字符串
- 請求失敗,4 字節(jié)的 "FAIL" 字符串,接著是一個 4 字節(jié)的十六進制長度,接著是一個字符串給出了失敗的原因。
- 作為一個特殊的擴展,'host:version',一個 4 字節(jié)的十六進制字符串對應(yīng)于服務(wù)器的內(nèi)部版本號
注意在 OKAY 之后,連接依然是存活的,這允許客戶端執(zhí)行其它的請求。但是在某些情況下,OKAY 將甚至改變連接的狀態(tài)。
比如,在 'host:transport:<serialnumber>' 請求的情況中,其中 '<serialnumber>' 用于標(biāo)識一個給定的設(shè)備/模擬器;在 "OKAY" 應(yīng)答之后,客戶端執(zhí)行的所有進一步的請求將直接進入對應(yīng)的 adbd 守護進程。
文件 SERVICES.TXT 列出了 ADB 當(dāng)前實現(xiàn)的所有服務(wù)。
2. 傳輸
ADB 傳輸建模了 ADB server 和一個設(shè)備或模擬器間的連接。當(dāng)前有兩種類型的傳輸:
- USB 傳輸,用于通過 USB 連接的物理設(shè)備
- 本地傳輸,用于在主機上運行的模擬器,通過 TCP 與服務(wù)器連接
理論上來說,編寫一個本地傳輸,代理 ADB server 和連接到/運行于另一臺機器上的設(shè)備/模擬器之間的連接應(yīng)該是可能的。盡管這還沒有完成。
每個傳輸可以攜帶一個或多個客戶端和它們指向的設(shè)備/模擬器間的多路復(fù)的用流。ADB server 必須適當(dāng)?shù)靥幚硪馔獾膫鬏斨袛啵ū热?,?dāng)設(shè)備被物理拔除時)。