Android調試橋接器,簡稱adb,是用於管理模擬器或真機狀態的萬能工具,採用了客戶端-服務器模型,包括三個部分:
* 客戶端部分,運行在開發用的電腦上,可以在命令行中運行adb命令來調用該客戶端,像ADB插件和DDMS這樣的Android工具也可以調用adb客戶端。
* 服務端部分,是運行在開發用電腦上的後臺進程,用於管理客戶端與運行在模擬器或真機的守護進程通信。
* 守護進程部分,運行於模擬器或手機的後臺。
當啓動adb客戶端時,客戶端首先檢測adb服務端進程是否運行,如果沒有運行,則啓動服務端。當服務端啓動時,它會綁定到本地的TCP5037端口,並且監聽從adb客戶端發來的命令——所有的adb客戶端都使用5037端口與adb服務端通信。
接下來服務端與所有正在運行的模擬器或手機連接。它通過掃描5555-5585之間的奇數號端口來搜索模擬器或手機,一旦發現adb守護進程,就通過此端口進行連接。需要說明的是,每一個模擬器或手機使用一對有序的端口,偶數號端口用於控制檯連接,奇數號端口用於adb連接,例如:
Emulator 1, adb: 5555
Emulator 2, console: 5556
Emulator 2, adb: 5557 ...
即如果模擬器與adb在5555端口連接,則其與控制檯的連接就是5554端口。
當服務端與所有的模擬器建立連接之後,就可以使用adb命令來控制或者訪問了。因爲服務端管理着連接並且可以接收到從多個adb客戶端的命令,所以可以從任何一個客戶端或腳本來控制任何模擬器或手機設備。
下文介紹了可以用來管理模擬器或手機的這些adb命令。如果是在Eclipse並且安裝了ADT插件的環境下開發Android應用程序,就不需要從命令行使用adb了,ADT插件已經提供了透明的集成。不過,還是可以在調試等需要的時候直接使用adb。
使用adb命令
從開發用電腦的命令行或腳本文件中使用adb命令的用法是:
adb [-d|-e|-s <serialNumber>] <command>
當使用的時候,程序會調用adb客戶端。因爲adb客戶端不需要關聯到任何模擬器,所以如果有多個模擬器或手機正在運行,就需要使用-d參數指定要操作的是哪一個,更多關於這些選項參數的使用可以參見Directing Commands to a Specific Emulator/Device Instance。
查詢模擬器或手機狀態
瞭解adb服務端連接的模擬器或手機可以幫助更好的使用adb命令,這可以通過devices命令列舉出來:
adb devices
執行結果是adb爲每一個設備輸出以下狀態信息:
* 序列號(serialNumber) — 由adb創建的使用控制檯端口號的用於唯一標識一個模擬器或手機設備的字符串,格式是 <設備類型>-<端口號>,例如: emulator-5554
* 狀態(state) — 連接狀態,其值是:
offline — 未連接或未響應
device —已經連接到服務商。注意這個狀態並不表示Android系統已經完全啓動起來,系統啓動的過程中已經可以連接adb,但這個狀態是正常的可操作狀態。
每一個設備的輸出形如:
[serialNumber] [state]
下面是 devices 命令和其執行結果:
$ adb devices
List of devices attached
emulator-5554 device
emulator-5556 device
emulator-5558 device
如果沒有模擬器或手機在運行,該狀態返回的是no device。
操作指定的模擬器或手機
如果有多個模擬器或手機正在運行,當使用adb命令的時候就需要指定目標設備,這可以通過使用-s選項參數實現,用法是:
adb -s <serialNumber> <command>
即可以在adb命令中使用序列號指定特定的目標,前文已經提到的devices命令可以實現查詢設備的序列號信息。
例如:
adb -s emulator-5556 install helloWorld.apk
需要注意的是,如果使用了-s而沒有指定設備的話,adb會報錯。
安裝應用程序
可以使用adb從開發用電腦中複製應用程序並且安裝到模擬器或手機上,使用install命令即可,在這個命令中,必須指定待安裝的.apk文件的路徑:
adb install <path_to_apk>
關於創建可安裝的應用的更多信息,請參見Android Asset Packaging Tool (aapt).
注意,如果使用了安裝有ADT插件的Eclipse開發環境,就不需要直接使用adb或aapt命令來安裝應用程序了,ADT插件可以自動完成這些操作。
轉發端口
可以使用forward 命令轉發端口 — 將特定端口上的請求轉發到模擬器或手機的不同的端口上。下例是從6100端口轉到7100端口:
adb forward tcp:6100 tcp:7100
也可以使用UNIX命名的socket標識:
adb forward tcp:6100 local:logd
與模擬器或手機傳輸文件
可以使用adb的 pull 和 push 命令從模擬器或手機中複製文件,或者將文件複製到模擬器或手機中。與 install 命令不同,它僅能複製.apk文件到特定的位置, pull 和 push 命令可以複製任意文件夾和文件到模擬器或手機的任何位置。
從模擬器或手機中複製一個文件或文件夾(遞歸的)使用:
adb pull <remote> <local>
複製一個文件或文件夾(遞歸的)到模擬器或手機中使用:
adb push <local> <remote>
在這個命令中<local>和<remote>引用的是文件或文件夾的路徑,在開發用電腦上的是local,在模擬器或手機上的是remote。
例如:
adb push foo.txt /sdcard/foo.txt
adb命令列表
下表列出了所有adb支持的命令及其說明:
類別 |
命令 |
說明 |
備註 |
可選項 |
-d |
命令僅對USB設備有效 |
如果有多個USB設備就會返回錯誤 |
-e |
命令僅對運行中的模擬器有效 |
如果有多個運行中的模擬器就會返回錯誤 |
|
-s <serialNumber> |
命令僅對adb關聯的特定序列號的模擬器或手機有效(例如 "emulator-5556"). |
如果不指定設備就會返回錯誤 |
|
一般項 |
devices |
輸出所有關聯的模擬器或手機設備列表 |
參見 Querying for Emulator/Device Instances 以獲得更多信息。 |
help |
輸出adb支持的命令 |
|
|
version |
輸出adb的版本號 |
|
|
調試項 |
logcat [<option>] [<filter-specs>] |
在屏幕上輸出日誌信息 |
|
bugreport |
爲報告bug,在屏幕上輸出dumpsys, dumpstate和 logcat數據 |
|
|
jdwp |
輸出有效的JDWP進程信息 |
可以使用 forward jdwp:<pid> 轉換端口以連接到指定的 JDWP 進程,例如: adb forward tcp:8000 jdwp:472 jdb -attach localhost:8000 |
|
數據項 |
install <path-to-apk> |
安裝應用程序(用完整路徑指定.apk文件) |
|
pull <remote> <local> |
從開發機COPY指定的文件到模擬器或手機 |
|
|
push <local> <remote> |
從模擬器或手機COPY文件到開發機 |
|
|
端口和網絡項 |
forward <local> <remote> |
從本地端口轉換連接到模擬器或手機的指定端口 |
端口可以使用以下格式表示: l tcp:<portnum> l local:<UNIX domain socket name> l dev:<character device name> l jdwp:<pid> |
ppp <tty> [parm]... |
通過USB運行UPP l <tty> —PPP流中的tty。例如:/dev/omap_csmi_ttyl。 l [parm]... — 0到多個PPP/PPPD 選項, 例如 defaultroute, local, notty等等。 注意不用自動啓動PPP連接 |
|
|
腳本項 |
get-serialno |
輸出adb對象的序列號 |
參見 Querying for Emulator/Device Instances以獲得更多信息。 |
get-state |
輸出adb設備的狀態 |
||
wait-for-device |
阻塞執行直到設備已經連接,即設備狀態是 device. |
可以在其他命令前加上此項,那樣的話adb就會等到模擬器或手機設備已經連接纔會執行命令,例如: 注意該命令並不等待系統完全啓動,因此不能追加需要在系統完全啓動才能執行的命令,例如install 命令需要Android包管理器支持,但它必須在系統完全啓動後纔有效。下面的命令 會在模擬器或手機與adb發生連接後就執行install,但系統還沒有完全啓動,所以會引起錯誤。 |
|
服務端項 |
start-server |
檢測adb服務進程是否啓動,如果沒啓動則啓動它。 |
|
kill-server |
終止服務端進程 |
|
|
Shell |
shell |
在目標模擬器或手機上啓動遠程SHELL |
參見 Issuing Shell Commands以獲得更多信息。 |
shell [<shellCommand>] |
在目標模擬器或手機上執行shellCommand然後退出遠程SHELL |
執行Shell命令
Adb提供了shell來在模擬器或手機上運行各種各樣的命令,這些命令的二進制形式存在於這個路徑中:
/system/bin/...
無論是否進入adb遠程shell,都可以使用 shell 命令來執。
在未進入遠程shell的情況下可以按下述格式執行單條命令:
adb [-d|-e|-s {<serialNumber>}] shell <shellCommand>
啓動遠程shell使用下面的格式:
adb [-d|-e|-s {<serialNumber>}] shell
退出遠程shell時使用CTRL+D 或 exit 終止會話。
以下是可以使用的shell命令的更多信息。
從遠程shell檢查sqlite3 數據庫
通過遠程shell,可以使用sqlite3命令行程序來管理由應用程序創建的SQLite數據庫。 sqlite3 工具包含很多有用的命令,例如 .dump 用於輸出表格的內容,.schema 用於爲已經存在的表輸出 SQL CREATE 語句。 並且該工具也提供了聯機執行SQLite命令的能力。
使用 sqlite3時,向前文描述的那樣進入模擬器的遠程shell,然後使用sqlite3 命令。也可以在調用 sqlite3時指定數據庫的全路徑。SQLite3數據庫存儲在/data/data/<package_name>/databases/路徑下。
示例:
$ adb -s emulator-5554 shell
# sqlite3 /data/data/com.example.google.rss.rssexample/databases/rssitems.db
SQLite version 3.3.12
Enter ".help" for instructions
.... enter commands, then quit...
sqlite> .exit
一旦運行了 sqlite3,就可以使用 sqlite3 命令,退出並返回遠程shell可以使用 exit 或 CTRL+D。
使用Monkey進行UI或應用程序測試
Monkey是運行於模擬器或手機上的一個程序,通過生成僞隨機的大量的系統級的用戶事件流來模擬操作,包括單擊、觸摸、手勢等。從而爲正在開發中的應用程序通過隨機響應進行壓力測試。
最簡單使用monkey的方式是通過下面的命令行,它可以運行指定的應用程序並向其發送500個僞隨機事件。
$ adb shell monkey -v -p your.package.name 500
關於monkey更多的選項及詳細信息,請參見UI/Application Exerciser Monkey。
其他Shell命令
下表列出了很多有效的adb shell命令,完整的列表可以通過啓動模擬器並且使用adb –help命令獲取。
adb shell ls /system/bin
幫助對於大部分命令是有效的。
Shell 命令 |
描述 |
備註 |
dumpsys |
在屏幕上顯示系統數據 |
The Dalvik Debug Monitor Service (DDMS) 工具提供了更易於使用的智能的調試環境。 |
dumpstate |
將狀態輸出到文件 |
|
logcat [<option>]... [<filter-spec>]... |
輸出日誌信息 |
|
dmesg |
在屏幕上輸出核心調試信息 |
|
start |
啓動或重新啓動模擬器或手機 |
|
stop |
停止模擬器或手機 |
|
使用logcat查看日誌
Android日誌系統提供了從衆多應用程序和系統程序中收集和查看調試信息的機制,這些信息被收集到一系統循環緩衝區中,可以 logcat 命令查看和過濾。
使用 logcat 命令
查看和跟蹤系統日誌緩衝區的命令logcat的一般用法是:
[adb] logcat [<option>] ... [<filter-spec>] ...
下文介紹過濾器和命令選項,詳細內容可參見Listing of logcat Command Options。
可以在開發機中通過遠程shell的方式使用logcat命令查看日誌輸出:
$ adb logcat
如果是在遠程shell中可直接使用命令:
# logcat
過濾日誌輸出
每一條日誌消息都有一個標記和優先級與其關聯。
標記是一個簡短的字符串,用於標識原始消息的來源 (例如"View" 來源於顯示系統)。
優先級是下面的字符,順序是從低到高:
V — 明細 (最低優先級)
D — 調試
I — 信息
W — 警告
E — 錯誤
F — 嚴重錯誤
S — 無記載 (最高優先級,沒有什麼會被記載)
通過運行logcat ,可以獲得一個系統中使用的標記和優先級的列表,觀察列表的前兩列,給出的格式是<priority>/<tag>。
這裏是一個日誌輸出的消息,優先級是“I”,標記是“ActivityManager”:
I/ActivityManager( 585): Starting activity: Intent { action=android.intent.action...}
如果想要減少輸出的內容,可以加上過濾器表達式進行限制,過濾器可以限制系統只輸出感興趣的標記-優先級組合。
過濾器表達式的格式是tag:priority ... ,其中tag是標記, priority是最小的優先級, 該標記標識的所有大於等於指定優先級的消息被寫入日誌。也可以在一個過濾器表達式中提供多個這樣的過濾,它們之間用空格隔開。
下面給出的例子是僅輸出標記爲“ActivityManager”並且優先級大於等於“Info”和標記爲“MyApp”並且優先級大於等於“Debug”的日誌:
adb logcat ActivityManager:I MyApp:D *:S
上述表達式最後的 *:S
用於設置所有標記的日誌優先級爲S,這樣可以確保僅有標記爲“View”(譯者注:應該爲ActivityManager,原文可能是筆誤)和“MyApp”的日誌被輸出,使用 *:S
是可以確保輸出符合指定的過濾器設置的一種推薦的方式,這樣過濾器就成爲了日誌輸出的“白名單”。
下面的表達是顯示所有優先級大於等於“warning”的日誌:
adb logcat *:W
如果在開發用電腦上運行 logcat
(相對於運行運程shell而言),也可以通過ANDROID_LOG_TAGS
環境變量設置默認的過濾器表達式:
export ANDROID_LOG_TAGS="ActivityManager:I MyApp:D *:S"
需要注意的是,如果是在遠程shell或是使用adb shell logcat
命令運行logcat
, ANDROID_LOG_TAGS
不會導出到模擬器或手機設備上。
控制日誌格式
日誌消息在標記和優先級之外還有很多元數據字段,這些字段可以通過修改輸出格式來控制輸出結果, -v
選項加上下面列出的內容可以控制輸出字段:
brief — 顯示優先級/標記和原始進程的PID (默認格式)
process — 僅顯示進程PID
tag — 僅顯示優先級/標記
thread — 僅顯示進程:線程和優先級/標記
raw — 顯示原始的日誌信息,沒有其他的元數據字段
time — 顯示日期,調用時間,優先級/標記,PID
long —顯示所有的元數據字段並且用空行分隔消息內容
可以使用 -v
啓動 logcat
來控制日誌格式:
[adb] logcat [-v <format>]
例如使用 thread
輸出格式:
adb logcat -v thread
注意只能在 -v
選項中指定一種格式。
Viewing Alternative Log Buffers
Android日誌系統爲日誌消息保持了多個循環緩衝區,而且不是所有的消息都被髮送到默認緩衝區,要想查看這些附加的緩衝區,可以使用-b
選項,以下是可以指定的緩衝區:
radio — 查看包含在無線/電話相關的緩衝區消息
events — 查看事件相關的消息
main — 查看主緩衝區 (默認緩衝區)
-
b
選項的用法:
[adb] logcat [-b <buffer>]
例如查看radio緩衝區:
adb logcat -b radio
查看stdout和stderr
默認的,Android系統發送 stdout
和 stderr
(System.out
和 System.err
)
輸出到 /dev/null
。
在 Dalvik VM進程,可以將輸出複製到日誌文件,在這種情況下,系統使用 stdout
和 stderr
標記寫入日誌,優先級是I
。
要想使用這種方式獲得輸出,需要停止運行中的模擬器或手機,然後使用命令 setprop
來允許輸出重定位,示例如下:
$ adb shell stop
$ adb shell setprop log.redirect-stdio true
$ adb shell start
系統會保留這一設置直到模擬器或手機退出,也可以在設備中增加/data/local.prop
以使得這一設備成爲默認配置。
Logcat命令選項列表
選項 |
描述 |
|
加載不同的緩衝區日誌,例如 |
|
清空(刷新)所有的日誌並且退出 |
|
在屏幕上輸出日誌並退出 |
|
將日誌輸出到文件<filename>,默認輸出是stdout. |
|
輸出日誌的大小 |
|
設置最大的循環數據<count>,默認是4,需要-r選項 |
|
每<kbytes>循環日誌文件,默認是16,需要 |
|
設置默認的過濾器爲無輸出 |
|
設置輸出格式,默認的是 |
停止adb服務
在某些情況下,可能需要終止然後重啓服務端進程,例如adb不響應命令的時候,可以通過重啓解決問題。
使用kill-server
可以終止服務端,然後使用其他的adb命令重啓。