Android 調(diào)試橋(adb)是多種用途的工具，該工具可以幫助你你管理設(shè)備或模擬器 的狀態(tài)。
可以通過下列幾種方法加入adb:
下面對(duì)adb進(jìn)行了介紹并描述了常見的使用.
Android 調(diào)試系統(tǒng)是一個(gè)面對(duì)客戶服務(wù)系統(tǒng)，包括三個(gè)組成部分:
當(dāng)你啟動(dòng)一個(gè)adb客戶端，客戶端首先確認(rèn)是否已有一個(gè)adb服務(wù)進(jìn)程在運(yùn)行。如果沒有，則啟動(dòng)服務(wù)進(jìn)程。當(dāng)服務(wù)器運(yùn)行， adb服務(wù)器就會(huì)綁定本地的TCP端口5037并監(jiān)聽adb客戶端發(fā)來的命令，—所有的adb客戶端都是用端口 5037與adb服務(wù)器對(duì)話的.
接著服務(wù)器將所有運(yùn)行中的模擬器或設(shè)備實(shí)例建立連接。它通過掃描所有5555到5585范圍內(nèi)的奇數(shù)端口來定位所有的模擬器或設(shè)備。一旦服務(wù)器找到了adb守護(hù)程序，它將建立一個(gè)到該端口的連接。請(qǐng)注意任何模擬器或設(shè)備實(shí)例會(huì)取得兩個(gè)連續(xù)的端口——一個(gè)偶數(shù)端口用來相應(yīng)控制臺(tái)的連接，和一個(gè)奇數(shù)端口用來響應(yīng)adb連接。比如說:
模擬器1，控制臺(tái)：端口5554
模擬器1，Adb端口5555
控制臺(tái)：端口 5556
Adb端口5557...
如上所示，模擬器實(shí)例通過5555端口連接adb，就如同使用5554端口連接控制臺(tái)一樣.
一旦服務(wù)器與所有模擬器實(shí)例建立連接，就可以使用adb命令控制和訪問該實(shí)例。因?yàn)榉?wù)器管理模擬器/設(shè)備實(shí)例的連接，和控制處理從來自多個(gè)adb客戶端來的命令，你可以通過任何客戶端(或腳本)來控制任何模擬器或設(shè)備實(shí)例.
以下的部分描述通過命令使用adb和管理模擬器/設(shè)備的狀態(tài)。要注意的是如果你用，裝有ADT插件的Eclipse開發(fā)Android程序，你就不需要通過命令行使用adb。ADT插件已經(jīng)透明的把a(bǔ)db集成到Eclipse中了，當(dāng)然，如果必要的話你也可以仍然直接使用adb，比如說調(diào)試.
發(fā)出Android命令：你可以在你的開發(fā)機(jī)上的命令行或腳本上發(fā)布Android命令，使用方法:
adb [-d|-e|-s <serialNumber>] <command>
當(dāng)你發(fā)出一個(gè)命令，系統(tǒng)啟用Android客戶端。客戶端并不與模擬器實(shí)例相關(guān)，所以如果雙服務(wù)器/設(shè)備是運(yùn)行中的，你需要用 -d 選項(xiàng)去為應(yīng)被控制的命令確定目標(biāo)實(shí)例。關(guān)于使用這個(gè)選項(xiàng)的更多信息，可以查看模擬器/設(shè)備實(shí)例術(shù)語控制命令 .
在發(fā)布adb命令之前，有必要知道什么樣的模擬器/設(shè)備實(shí)例與adb服務(wù)器是相連的。可以通過使用devices命令來得到一系列相關(guān)聯(lián)的模擬器/設(shè)備:
adb devices
• 作為回應(yīng)，adb為每個(gè)實(shí)例都制定了相應(yīng)的狀態(tài)信息:
<type>-<consolePort> 唯一地識(shí)別一個(gè)模擬器/設(shè)備實(shí)例。下面是一個(gè)序列號(hào)的例子： emulator-5554offline — 此實(shí)例沒有與adb相連接或者無法響應(yīng).device — 此實(shí)例正與adb服務(wù)器連接。注意這個(gè)狀態(tài)并不能百分之百地表示在運(yùn)行和操作Android系統(tǒng)，因此這個(gè)實(shí)例是當(dāng)系統(tǒng)正在運(yùn)行的時(shí)候與adb連接的。然而，在系統(tǒng)啟動(dòng)之后，就是一個(gè)模擬器/設(shè)備狀態(tài)的正常運(yùn)行狀態(tài)了.每個(gè)實(shí)例的輸出都有如下固定的格式:
[serialNumber] [state]
下面是一個(gè)展示devices 命令和輸出的例子 :
$ adb devicesList of devices attached emulator-5554 deviceemulator-5556 deviceemulator-5558 device
如果當(dāng)前沒有模擬器/設(shè)備運(yùn)行，adb則返回 no device .
如果有多個(gè)模擬器/設(shè)備實(shí)例在運(yùn)行，在發(fā)布adb命令時(shí)需要指定一個(gè)目標(biāo)實(shí)例。這樣做，請(qǐng)使用-s 選項(xiàng)的命令。在使用的-s 選項(xiàng)是
adb -s <serialNumber> <command>
如上所示，給一個(gè)命令指定了目標(biāo)實(shí)例，這個(gè)目標(biāo)實(shí)例使用由adb分配的序列號(hào)。你可以使用 devices 命令來獲得運(yùn)行著的模擬器/設(shè)備實(shí)例的序列號(hào)
示例如下:
adb -s emulator-5556 install helloWorld.apk
注意這點(diǎn)，如果沒有指定一個(gè)目標(biāo)模擬器/設(shè)備實(shí)例就執(zhí)行 -s 這個(gè)命令的話，adb會(huì)產(chǎn)生一個(gè)錯(cuò)誤.
你可以使用adb從你的開發(fā)電腦上復(fù)制一個(gè)應(yīng)用程序，并且將其安裝在一個(gè)模擬器/設(shè)備實(shí)例。像這樣做，使用install 命令。這個(gè)install 命令要求你必須指定你所要安裝的.apk文件的路徑:
adb install <path_to_apk>
為了獲取更多的關(guān)于怎樣創(chuàng)建一個(gè)可以安裝在模擬器/設(shè)備實(shí)例上的.apk文件的信息，可參照Android Asset Packaging Tool (aapt).
要注意的是，如果你正在使用Eclipse IDE并且已經(jīng)安裝過ADT插件，那么就不需要直接使用adb（或者aapt）去安裝模擬器/設(shè)備上的應(yīng)用程序。否則，ADT插件代你全權(quán)處理應(yīng)用程序的打包和安裝.
可以使用 forward 命令進(jìn)行任意端口的轉(zhuǎn)發(fā)——一個(gè)模擬器/設(shè)備實(shí)例的某一特定主機(jī)端口向另一不同端口的轉(zhuǎn)發(fā)請(qǐng)求。下面演示了如何建立從主機(jī)端口6100到模擬器/設(shè)備端口7100的轉(zhuǎn)發(fā)。
adb forward tcp:6100 tcp:7100
同樣地，可以使用adb來建立命名為抽象的UNIX域套接口，上述過程如下所示:
adb forward tcp:6100 local:logd
可以使用adbpull ,push 命令將文件復(fù)制到一個(gè)模擬器/設(shè)備實(shí)例的數(shù)據(jù)文件或是從數(shù)據(jù)文件中復(fù)制。install 命令只將一個(gè).apk文件復(fù)制到一個(gè)特定的位置，與其不同的是，pull 和 push 命令可令你復(fù)制任意的目錄和文件到一個(gè)模擬器/設(shè)備實(shí)例的任何位置。
從模擬器或者設(shè)備中復(fù)制文件或目錄，使用(如下命):
adb pull <remote> <local>
將文件或目錄復(fù)制到模擬器或者設(shè)備，使用（如下命令）
adb push <local> <remote>
在這些命令中， <local> 和<remote> 分別指通向自己的發(fā)展機(jī)（本地）和模擬器/設(shè)備實(shí)例（遠(yuǎn)程）上的目標(biāo)文件/目錄的路徑
下面是一個(gè)例子：:
adb push foo.txt /sdcard/foo.txt
下列表格列出了adb支持的所有命令,并對(duì)它們的意義和使用方法做了說明.
| Category | Command | Description | Comments |
|---|---|---|---|
| Options | -d | 僅僅通過USB接口來管理abd. | 如果不只是用USB接口來管理則返回錯(cuò)誤. |
-e | 僅僅通過模擬器實(shí)例來管理adb. | 如果不是僅僅通過模擬器實(shí)例管理則返回錯(cuò)誤. | |
-s <serialNumber> | 通過模擬器/設(shè)備的允許的命令號(hào)碼來發(fā)送命令來管理adb (比如: "emulator-5556"). | 如果沒有指定號(hào)碼，則會(huì)報(bào)錯(cuò). | |
| General | devices | 查看所有連接模擬器/設(shè)備的設(shè)施的清單. | 查看 Querying for Emulator/Device Instances 獲取更多相關(guān)信息. |
help | 查看adb所支持的所有命令。. | ||
version | 查看adb的版本序列號(hào). | ||
| Debug | logcat [<option>] [<filter-specs>] | 將日志數(shù)據(jù)輸出到屏幕上. | |
bugreport | 查看bug的報(bào)告，如dumpsys ,dumpstate ,和logcat 信息。 | ||
jdwp | 查看指定的設(shè)施的可用的JDWP信息. | 可以用 forward jdwp:<pid> 端口映射信息來連接指定的JDWP進(jìn)程.例如： adb forward tcp:8000 jdwp:472 jdb -attach localhost:8000 | |
| Data | install <path-to-apk> | 安裝Android為（可以模擬器/設(shè)施的數(shù)據(jù)文件.apk指定完整的路徑）. | |
pull <remote> <local> | 將指定的文件從模擬器/設(shè)施的拷貝到電腦上. | ||
push <local> <remote> | 將指定的文件從電腦上拷貝到模擬器/設(shè)備中. | ||
| Ports and Networking | forward <local> <remote> | 用本地指定的端口通過socket方法遠(yuǎn)程連接模擬器/設(shè)施 | 端口需要描述下列信息:
|
ppp <tty> [parm]... | 通過USB運(yùn)行ppp：
需要提醒你的不能自動(dòng)啟動(dòng)PDP連接. | ||
| Scripting | get-serialno | 查看adb實(shí)例的序列號(hào). | 查看 Querying for Emulator/Device Instances 可以獲得更多信息. |
get-state | 查看模擬器/設(shè)施的當(dāng)前狀態(tài). | ||
wait-for-device | 如果設(shè)備不聯(lián)機(jī)就不讓執(zhí)行,--也就是實(shí)例狀態(tài)是 device 時(shí). | 你可以提前把命令轉(zhuǎn)載在adb的命令器中,在命令器中的命令在模擬器/設(shè)備連接之前是不會(huì)執(zhí)行其它命令的. 示例如下: adb wait-for-device shell getprop需要提醒的是這些命令在所有的系統(tǒng)啟動(dòng)啟動(dòng)起來之前是不會(huì)啟動(dòng)adb的 所以在所有的系統(tǒng)啟動(dòng)起來之前你也不能執(zhí)行其它的命令. 比如：運(yùn)用 install 的時(shí)候就需要Android包，這些包只有系統(tǒng)完全啟動(dòng)。例如： adb wait-for-device install <app>.apk上面的命令只有連接上了模擬器/設(shè)備連接上了adb服務(wù)才會(huì)被執(zhí)行，而在Android系統(tǒng)完全啟動(dòng)前執(zhí)行就會(huì)有錯(cuò)誤發(fā)生. | |
| Server | start-server | 選擇服務(wù)是否啟動(dòng)adb服務(wù)進(jìn)程. | |
kill-server | 終止adb服務(wù)進(jìn)程. | ||
| Shell | shell | 通過遠(yuǎn)程shell命令來控制模擬器/設(shè)備實(shí)例. | 查看 獲取更多信息 for more information. |
shell [<shellCommand>] | 連接模擬器/設(shè)施執(zhí)行shell命令，執(zhí)行完畢后退出遠(yuǎn)程shell端l. |
Adb 提供了shell端，通過shell端你可以在模擬器或設(shè)備上運(yùn)行各種命令。這些命令以2進(jìn)制的形式保存在本地的模擬器或設(shè)備的文件系統(tǒng)中:
/system/bin/...
不管你是否完全進(jìn)入到模擬器/設(shè)備的adb遠(yuǎn)程shell端，你都能 shell 命令來執(zhí)行命令.
當(dāng)沒有完全進(jìn)入到遠(yuǎn)程shell的時(shí)候，這樣使用shell 命令來執(zhí)行一條命令:
adb [-d|-e|-s {<serialNumber>}] shell <shellCommand> 在模擬器/設(shè)備中不用遠(yuǎn)程shell端時(shí)，這樣使用shell 命 :
adb [-d|-e|-s {<serialNumber>}] shell 通過操作CTRL+D 或exit 就可以退出shell遠(yuǎn)程連接.
下面一些就將告訴你更多的關(guān)于shell命令的知識(shí).
通過adb遠(yuǎn)程shell端，你可以通過Android軟sqlite3 命令程序來管理數(shù)據(jù)庫。sqlite3 工具包含了許多使用命令，比如：.dump 顯示表的內(nèi)容，.schema 可以顯示出已經(jīng)存在的表空間的SQL CREATE結(jié)果集。Sqlite3還允許你遠(yuǎn)程執(zhí)行sql命令.
通過sqlite3 , 按照前幾節(jié)的方法登陸模擬器的遠(yuǎn)程shell端，然后啟動(dòng)工具就可以使用sqlite3 命令。當(dāng)sqlite3 啟動(dòng)以后，你還可以指定你想查看的數(shù)據(jù)庫的完整路徑。模擬器/設(shè)備實(shí)例會(huì)在文件夾中保存SQLite3數(shù)據(jù)庫. /data/data/<package_name> /databases / .
示例如下:
$ adb -s emulator-5554 shell# sqlite3 /data/data/com.example.google.rss.rssexample/databases/rssitems.dbSQLite version 3.3.12Enter ".help" for instructions.... enter commands, then quit...sqlite> .exit
當(dāng)你啟動(dòng)sqlite3的時(shí)候，你就可以通過shell端發(fā)送 sqlite3 ,命令了。用exit 或 CTRL+D 退出adb遠(yuǎn)程shell端.
當(dāng)Monkey程序在模擬器或設(shè)備運(yùn)行的時(shí)候，如果用戶出發(fā)了比如點(diǎn)擊，觸摸，手勢或一些系統(tǒng)級(jí)別的事件的時(shí)候，它就會(huì)產(chǎn)生隨機(jī)脈沖，所以可以用Monkey用隨機(jī)重復(fù)的方法去負(fù)荷測試你開發(fā)的軟件.
最簡單的方法就是用用下面的命令來使用Monkey，這個(gè)命令將會(huì)啟動(dòng)你的軟件并且觸發(fā)500個(gè)事件.
$ adb shell monkey -v -p your.package.name 500
更多的關(guān)于命令Monkey的命令的信息，可以查看UI/Application Exerciser Monkey documentation page.
文檔頁面
下面的表格列出了一些adbshell命令，如果需要全部的命令和程序，可以啟動(dòng)模擬器實(shí)例并且用adb -help命令 .
adb shell ls /system/bin
對(duì)大部門命令來說，help都是可用的.
| Shell Command | Description | Comments |
|---|---|---|
dumpsys | 清除屏幕中的系統(tǒng)數(shù)據(jù)n. | Dalvik Debug Monitor Service (DDMS)工具提供了完整的調(diào)試、. |
dumpstate | 清除一個(gè)文件的狀態(tài). | |
logcat [<option>]... [<filter-spec>]... | 啟動(dòng)信息日志并且但因輸出到屏幕上. | |
dmesg | 輸出主要的調(diào)試信息到屏幕上. | |
start | 啟動(dòng)或重啟一個(gè)模擬器/設(shè)備實(shí)例. | |
stop | 關(guān)閉一個(gè)模擬器/設(shè)備實(shí)例. |
Android日志系統(tǒng)提供了記錄和查看系統(tǒng)調(diào)試信息的功能。日志都是從各種軟件和一些系統(tǒng)的緩沖區(qū)中記錄下來的，緩沖區(qū)可以通過 logcat 命令來查看和使用.
你可以用 logcat 命令來查看系統(tǒng)日志緩沖區(qū)的內(nèi)容:
[adb] logcat [<option>] ... [<filter-spec>] ...
請(qǐng)查看Listing of logcat Command Options ，它對(duì)logcat命令有詳細(xì)的描述 .
你也可以在你的電腦或運(yùn)行在模擬器/設(shè)備上的遠(yuǎn)程adb shell端來使用logcat 命令，也可以在你的電腦上查看日志輸出。
$ adb logcat
你也這樣使用：
# logcat
每一個(gè)輸出的Android日志信息都有一個(gè)標(biāo)簽和它的優(yōu)先級(jí).
V — Verbose (lowest priority)D — DebugI — InfoW — WarningE — ErrorF — FatalS — Silent (highest priority, on which nothing is ever printed) 在運(yùn)行l(wèi)ogcat的時(shí)候在前兩列的信息中你就可以看到 logcat 的標(biāo)簽列表和優(yōu)先級(jí)別,它是這樣標(biāo)出的:<priority>/<tag> .
下面是一個(gè)logcat輸出的例子,它的優(yōu)先級(jí)就似乎I,標(biāo)簽就是ActivityManage:
I/ActivityManager( 585): Starting activity: Intent { action=android.intent.action...} 為了讓日志輸出能體現(xiàn)管理的級(jí)別,你還可以用過濾器來控制日志輸出,過濾器可以幫助你描述系統(tǒng)的標(biāo)簽等級(jí).
過濾器語句按照下面的格式描tag:priority ... , tag 表示是標(biāo)簽, priority 是表示標(biāo)簽的報(bào)告的最低等級(jí). 從上面的tag的中可以得到日志的優(yōu)先級(jí). 你可以在過濾器中多次寫tag:priority .
這些說明都只到空白結(jié)束。下面有一個(gè)列子，例子表示支持所有的日志信息，除了那些標(biāo)簽為”ActivityManager”和優(yōu)先級(jí)為”Info”以上的和標(biāo)簽為” MyApp”和優(yōu)先級(jí)為” Debug”以上的。小等級(jí),優(yōu)先權(quán)報(bào)告為tag.
adb logcat ActivityManager:I MyApp:D *:S
上面表達(dá)式的最后的元素 *:S ,，是設(shè)置所有的標(biāo)簽為"silent"，所有日志只顯示有"View" and "MyApp"的，用 *:S 的另一個(gè)用處是 能夠確保日志輸出的時(shí)候是按照過濾器的說明限制的，也讓過濾器也作為一項(xiàng)輸出到日志中.
下面的過濾語句指顯示優(yōu)先級(jí)為warning或更高的日志信息:
adb logcat *:W
如果你電腦上運(yùn)行logcat ，相比在遠(yuǎn)程adbshell端，你還可以為環(huán)境變量ANDROID_LOG_TAGS :輸入一個(gè)參數(shù)來設(shè)置默認(rèn)的過濾
export ANDROID_LOG_TAGS="ActivityManager:I MyApp:D *:S"
需要注意的是ANDROID_LOG_TAGS 過濾器如果通過遠(yuǎn)程shell運(yùn)行logcat 或用adb shell logcat 來運(yùn)行模擬器/設(shè)備不能輸出日志.
日志信息包括了許多元數(shù)據(jù)域包括標(biāo)簽和優(yōu)先級(jí)。可以修改日志的輸出格式，所以可以顯示出特定的元數(shù)據(jù)域。可以通過 -v 選項(xiàng)得到格式化輸出日志的相關(guān)信息.
brief — Display priority/tag and PID of originating process (the default format).process — Display PID only.tag — Display the priority/tag only.thread — Display process:thread and priority/tag only.raw — Display the raw log message, with no other metadata fields.time — Display the date, invocation time, priority/tag, and PID of the originating process.long — Display all metadata fields and separate messages with a blank lines. 當(dāng)啟動(dòng)了logcat ，你可以通過-v 選項(xiàng)來指定輸出格式:
[adb] logcat [-v <format>]
下面是用 thread 來產(chǎn)生的日志格式:
adb logcat -v thread
需要注意的是你只能-v 選項(xiàng)來規(guī)定輸出格式 option.
Android日志系統(tǒng)有循環(huán)緩沖區(qū)，并不是所有的日志系統(tǒng)都有默認(rèn)循環(huán)緩沖區(qū)。為了得到日志信息，你需要通過-b 選項(xiàng)來啟動(dòng)logcat 。如果要使用循環(huán)緩沖區(qū)，你需要查看剩余的循環(huán)緩沖期:
radio — 查看緩沖區(qū)的相關(guān)的信息.events — 查看和事件相關(guān)的的緩沖區(qū).main — 查看主要的日志緩沖區(qū) -b 選項(xiàng)使用方法:
[adb] logcat [-b <buffer>]
下面的例子表示怎么查看日志緩沖區(qū)包含radio 和 telephony信息:
adb logcat -b radio
在默認(rèn)狀態(tài)下，Android系統(tǒng)有stdout 和 stderr (System.out 和System.err )輸出到/dev/null ，在運(yùn)行Dalvik VM的進(jìn)程中，有一個(gè)系統(tǒng)可以備份日志文件。在這種情況下，系統(tǒng)會(huì)用stdout 和stderr 和優(yōu)先級(jí) I.來記錄日志信息
通過這種方法指定輸出的路徑，停止運(yùn)行的模擬器/設(shè)備，然后通過用 setprop 命令遠(yuǎn)程輸入日志
$ adb shell stop$ adb shell setprop log.redirect-stdio true$ adb shell start
系統(tǒng)直到你關(guān)閉模擬器/設(shè)備前設(shè)置會(huì)一直保留，可以通過添加/data/local.prop 可以使用模擬器/設(shè)備上的默認(rèn)設(shè)置
| Option | Description |
|---|---|
-b <buffer> | 加載一個(gè)可使用的日志緩沖區(qū)供查看，比如event 和radio . 默認(rèn)值是main 。具體查看Viewing Alternative Log Buffers. |
-c | 清楚屏幕上的日志. |
-d | 輸出日志到屏幕上. |
-f <filename> | 指定輸出日志信息的<filename> ，默認(rèn)是stdout . |
-g | 輸出指定的日志緩沖區(qū)，輸出后退出. |
-n <count> | 設(shè)置日志的最大數(shù)目<count> .，默認(rèn)值是4，需要和 -r 選項(xiàng)一起使用。 |
-r <kbytes> | 每<kbytes> 時(shí)輸出日志，默認(rèn)值為16，需要和-f 選項(xiàng)一起使用. |
-s | 設(shè)置默認(rèn)的過濾級(jí)別為silent. |
-v <format> | 設(shè)置日志輸入格式，默認(rèn)的是brief 格式，要知道更多的支持的格式，參看Controlling Log Output Format . |
在某些情況下，你可能需要終止Android 調(diào)試系統(tǒng)的運(yùn)行,然后再重新啟動(dòng)它。例如,如果Android 調(diào)試系統(tǒng)不響應(yīng)命令，你可以先終止服務(wù)器然后再重啟，這樣就可能解決這個(gè)問題.
用kill-server 可以終止adb server。你可以用adb發(fā)出的任何命令來重新啟動(dòng)服務(wù)器.
新聞熱點(diǎn)
疑難解答
圖片精選
