Android 調試橋(adb)是多種用途的工具,該工具能夠幫助你你管理設備或模擬器 的狀態。java
能夠經過下列幾種方法加入adb:android
下面對adb進行了介紹並描述了常見的使用.sql
Android 調試系統是一個面對客戶服務系統,包括三個組成部分:shell
當你啓動一個adb客戶端,客戶端首先確認是否已有一個adb服務進程在運行。若是沒有,則啓動服務進程。當服務器運行, adb服務器就會綁定本地的TCP端口5037並監聽adb客戶端發來的命令,—全部的adb客戶端都是用端口 5037與adb服務器對話的.數據庫
接着服務器將全部運行中的模擬器或設備實例創建鏈接。它經過掃描全部5555到5585範圍內的奇數端口來定位全部的模擬器或設備。一旦服務器找到 了adb守護程序,它將創建一個到該端口的鏈接。請注意任何模擬器或設備實例會取得兩個連續的端口——一個偶數端口用來相應控制檯的鏈接,和一個奇數端口 用來響應adb鏈接。好比說:服務器
模擬器1,控制檯:端口5554
模擬器1,Adb端口5555
控制檯:端口 5556
Adb端口5557...
如上所示,模擬器實例經過5555端口鏈接adb,就如同使用5554端口鏈接控制檯同樣.app
一旦服務器與全部模擬器實例創建鏈接,就可使用adb命令控制和訪問該實例。由於服務器管理模擬器/設備實例的鏈接,和控制處理歷來自多個adb客戶端來的命令,你能夠經過任何客戶端(或腳本)來控制任何模擬器或設備實例.dom
如下的部分描述經過命令使用adb和管理模擬器/設備的狀態。要注意的是若是你用,裝有ADT插件的Eclipse開發Android程序,你就不 須要經過命令行使用adb。ADT插件已經透明的把adb集成到Eclipse中了,固然,若是必要的話你也能夠仍然直接使用adb,好比說調試.socket
發出Android命令: 你能夠在你的開發機上的命令行或腳本上發佈Android命令,使用方法:tcp
adb [-d|-e|-s <serialNumber>] <command>
當你發出一個命令,系統啓用Android客戶端。客戶端並不與模擬器實例相關,因此若是雙服務器/設備是運行中的,你須要用 -d
選項去爲應被控制的命令肯定目標實例。關於使用這個選項的更多信息,能夠查看模擬器/設備實例術語控制命令 .
在發佈adb命令以前,有必要知道什麼樣的模擬器/設備實例與adb服務器是相連的。能夠經過使用devices
命令來獲得一系列相關聯的模擬器/設備:
adb devices
•做爲迴應,adb爲每一個實例都制定了相應的狀態信息:
<type>-<consolePort>
惟一地識別一個模擬器/設備實例。下面是一個序列號的例子: emulator-5554
offline
— 此實例沒有與adb相鏈接或者沒法響應.device
— 此實例正與adb服務器鏈接。注意這個狀態並不能百分之百地表示在運行和操做Android系統,所以這個實例是當系統正在運行的時候與adb鏈接的。然而,在系統啓動以後,就是一個模擬器/設備狀態的正常運行狀態了.每一個實例的輸出都有以下固定的格式:
[serialNumber] [state]
下面是一個展現devices
命令和輸出的例子 :
$ adb devicesList of devices attached emulator-5554 deviceemulator-5556 deviceemulator-5558 device
若是當前沒有模擬器/設備運行,adb則返回 no device
.
若是有多個模擬器/設備實例在運行,在發佈adb命令時須要指定一個目標實例。 這樣作,請使用-s
選項的命令。在使用的-s
選項是
adb -s <serialNumber> <command>
如上所示,給一個命令指定了目標實例,這個目標實例使用由adb分配的序列號。你可使用 devices
命令來得到運行着的模擬器/設備實例的序列號
示例以下:
adb -s emulator-5556 install helloWorld.apk
注意這點,若是沒有指定一個目標模擬器/設備實例就執行 -s
這個命令的話,adb會產生一個錯誤.
你可使用adb從你的開發電腦上覆制一個應用程序,而且將其安裝在一個模擬器/設備實例。像這樣作,使用install
命令。這個install
命令要求你必須指定你所要安裝的.apk文件的路徑:
adb install <path_to_apk>
爲了獲取更多的關於怎樣建立一個能夠安裝在模擬器/設備實例上的.apk文件的信息,可參照Android Asset Packaging Tool (aapt).
要注意的是,若是你正在使用Eclipse IDE而且已經安裝過ADT插件,那麼就不須要直接使用adb(或者aapt)去安裝模擬器/設備上的應用程序。不然,ADT插件代你全權處理應用程序的打包和安裝.
可使用 forward
命令進行任意端口的轉發——一個模擬器/設備實例的某一特定主機端口向另外一不一樣端口的轉發請求。下面演示瞭如何創建從主機端口6100到模擬器/設備端口7100的轉發。
adb forward tcp:6100 tcp:7100
一樣地,可使用adb來創建命名爲抽象的UNIX域套接口,上述過程以下所示:
adb forward tcp:6100 local:logd
可使用adbpull
,push
命令將文件複製到一個模擬器/設備實例的數據文件或是從數據文件中複製。install
命令只將一個.apk文件複製到一個特定的位置,與其不一樣的是,pull
和 push
命令可令你複製任意的目錄和文件到一個模擬器/設備實例的任何位置。
從模擬器或者設備中複製文件或目錄,使用(以下命):
adb pull <remote> <local>
將文件或目錄複製到模擬器或者設備,使用(以下命令)
adb push <local> <remote>
在這些命令中, <local>
和<remote>
分別指通向本身的發展機(本地)和模擬器/設備實例(遠程)上的目標文件/目錄的路徑
下面是一個例子::
adb push foo.txt /sdcard/foo.txt
下列表格列出了adb支持的全部命令,並對它們的意義和使用方法作了說明.
Category | Command | Description | Comments |
---|---|---|---|
Options | -d |
僅僅經過USB接口來管理abd. | 若是不僅是用USB接口來管理則返回錯誤. |
-e |
僅僅經過模擬器實例來管理adb. | 若是不是僅僅經過模擬器實例管理則返回錯誤. | |
-s <serialNumber> |
經過模擬器/設備的容許的命令號碼來發送命令來管理adb (好比: "emulator-5556"). | 若是沒有指定號碼,則會報錯. | |
General | devices |
查看全部鏈接模擬器/設備的設施的清單. | 查看 Querying for Emulator/Device Instances獲取更多相關信息. |
help |
查看adb所支持的全部命令。. | ||
version |
查看adb的版本序列號. | ||
Debug | 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 |
|
Data | install <path-to-apk> |
安裝Android爲(能夠模擬器/設施的數據文件.apk指定完整的路徑). | |
pull <remote> <local> |
將指定的文件從模擬器/設施的拷貝到電腦上. | ||
push <local> <remote> |
將指定的文件從電腦上拷貝到模擬器/設備中. | ||
Ports and Networking | forward <local> <remote> |
用本地指定的端口經過socket方法遠程鏈接模擬器/設施 | 端口須要描述下列信息:
|
ppp <tty> [parm]... |
經過USB運行ppp:
須要提醒你的不能自動啓動PDP鏈接. |
||
Scripting | get-serialno |
查看adb實例的序列號. | 查看 Querying for Emulator/Device Instances能夠得到更多信息. |
get-state |
查看模擬器/設施的當前狀態. | ||
wait-for-device |
若是設備不聯機就不讓執行,--也就是實例狀態是 device 時. |
你能夠提早把命令轉載在adb的命令器中,在命令器中的命令在模擬器/設備鏈接以前是不會執行其它命令的. 示例以下: adb wait-for-device shell getprop須要提醒的是這些命令在全部的系統啓動啓動起來以前是不會啓動adb的 因此在全部的系統啓動起來以前你也不能執行其它的命令. 好比:運用 install 的時候就須要Android包,這些包只有系統徹底啓動。例如: adb wait-for-device install <app>.apk上面的命令只有鏈接上了模擬器/設備鏈接上了adb服務纔會被執行,而在Android系統徹底啓動前執行就會有錯誤發生. |
|
Server | start-server |
選擇服務是否啓動adb服務進程. | |
kill-server |
終止adb服務進程. | ||
Shell | shell |
經過遠程shell命令來控制模擬器/設備實例. | 查看 獲取更多信息 for more information. |
shell [<shellCommand>] |
鏈接模擬器/設施執行shell命令,執行完畢後退出遠程shell端l. |
Adb 提供了shell端,經過shell端你能夠在模擬器或設備上運行各類命令。這些命令以2進制的形式保存在本地的模擬器或設備的文件系統中:
/system/bin/...
無論你是否徹底進入到模擬器/設備的adb遠程shell端,你都能 shell
命令來執行命令.
當沒有徹底進入到遠程shell的時候,這樣使用shell
命令來執行一條命令:
adb [-d|-e|-s {<serialNumber>}] shell <shellCommand>
在模擬器/設備中不用遠程shell端時,這樣使用shell
命 :
adb [-d|-e|-s {<serialNumber>}] shell
經過操做CTRL+D
或exit
就能夠退出shell遠程鏈接.
下面一些就將告訴你更多的關於shell命令的知識.
經過adb遠程shell端,你能夠經過Android軟sqlite3 命令程序來管理數據庫。sqlite3
工具包含了許多使用命令,好比:.dump
顯示錶的內容,.schema
能夠顯示出已經存在的表空間的SQL CREATE結果集。Sqlite3還容許你遠程執行sql命令.
經過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.dbSQLite version 3.3.12Enter ".help" for instructions.... enter commands, then quit...sqlite> .exit
當你啓動sqlite3的時候,你就能夠經過shell端發送 sqlite3
,命令了。用exit
或 CTRL+D
退出adb遠程shell端.
當Monkey程序在模擬器或設備運行的時候,若是用戶出發了好比點擊,觸摸,手勢或一些系統級別的事件的時候,它就會產生隨機脈衝,因此能夠用Monkey用隨機重複的方法去負荷測試你開發的軟件.
最簡單的方法就是用用下面的命令來使用Monkey,這個命令將會啓動你的軟件而且觸發500個事件.
$ adb shell monkey -v -p your.package.name 500
更多的關於命令Monkey的命令的信息,能夠查看UI/Application Exerciser Monkey documentation page.
文檔頁面
下面的表格列出了一些adbshell命令,若是須要所有的命令和程序,能夠啓動模擬器實例而且用adb -help
命令 .
adb shell ls /system/bin
對大部門命令來講,help都是可用的.
Shell Command | Description | Comments |
---|---|---|
dumpsys |
清除屏幕中的系統數據n. | Dalvik Debug Monitor Service (DDMS)工具提供了完整的調試、. |
dumpstate |
清除一個文件的狀態. | |
logcat [<option>]... [<filter-spec>]... |
啓動信息日誌而且但因輸出到屏幕上. | |
dmesg |
輸出主要的調試信息到屏幕上. | |
start |
啓動或重啓一個模擬器/設備實例. | |
stop |
關閉一個模擬器/設備實例. |
Android日誌系統提供了記錄和查看系統調試信息的功能。日誌都是從各類軟件和一些系統的緩衝區中記錄下來的,緩衝區能夠經過 logcat
命令來查看和使用.
你能夠用 logcat
命令來查看系統日誌緩衝區的內容:
[adb] logcat [<option>] ... [<filter-spec>] ...
請查看Listing of logcat Command Options ,它對logcat命令有詳細的描述 .
你也能夠在你的電腦或運行在模擬器/設備上的遠程adb shell端來使用logcat
命令,也能夠在你的電腦上查看日誌輸出。
$ adb logcat
你也這樣使用:
# logcat
每個輸出的Android日誌信息都有一個標籤和它的優先級.
V
— Verbose (lowest priority)D
— DebugI
— InfoW
— WarningE
— ErrorF
— FatalS
— Silent (highest priority, on which nothing is ever printed)在運行logcat的時候在前兩列的信息中你就能夠看到 logcat
的標籤列表和優先級別,它是這樣標出的:<priority>/<tag>
.
下面是一個logcat輸出的例子,它的優先級就彷佛I,標籤就是ActivityManage:
I/ActivityManager( 585): Starting activity: Intent { action=android.intent.action...}
爲了讓日誌輸出能體現管理的級別,你還能夠用過濾器來控制日誌輸出,過濾器能夠幫助你描述系統的標籤等級.
過濾器語句按照下面的格式描tag:priority ...
, tag
表示是標籤, priority
是表示標籤的報告的最低等級. 從上面的tag的中能夠獲得日誌的優先級. 你能夠在過濾器中屢次寫tag:priority
.
這些說明都只到空白結束。下面有一個列子,例子表示支持全部的日誌信息,除了那些標籤爲」ActivityManager」和優先級爲」Info」以上的和標籤爲」 MyApp」和優先級爲」 Debug」以上的。 小等級,優先權報告爲tag.
adb logcat ActivityManager:I MyApp:D *:S
上面表達式的最後的元素 *:S
,,是設置全部的標籤爲"silent",全部日誌只顯示有"View" and "MyApp"的,用 *:S
的另外一個用處是 可以確保日誌輸出的時候是按照過濾器的說明限制的,也讓過濾器也做爲一項輸出到日誌中.
下面的過濾語句指顯示優先級爲warning或更高的日誌信息:
adb logcat *:W
若是你電腦上運行logcat
,相比在遠程adbshell端,你還能夠爲環境變量ANDROID_LOG_TAGS
:輸入一個參數來設置默認的過濾
export ANDROID_LOG_TAGS="ActivityManager:I MyApp:D *:S"
須要注意的是ANDROID_LOG_TAGS
過濾器若是經過遠程shell運行logcat
或用adb shell logcat
來運行模擬器/設備不能輸出日誌.
日誌信息包括了許多元數據域包括標籤和優先級。能夠修改日誌的輸出格式,因此能夠顯示出特定的元數據域。能夠經過 -v
選項獲得格式化輸出日誌的相關信息.
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.當啓動了logcat
,你能夠經過-v
選項來指定輸出格式:
[adb] logcat [-v <format>]
下面是用 thread
來產生的日誌格式:
adb logcat -v thread
須要注意的是你只能-v
選項來規定輸出格式 option.
Android日誌系統有循環緩衝區,並非全部的日誌系統都有默認循環緩衝區。爲了獲得日誌信息,你須要經過-b
選項來啓動logcat
。若是要使用循環緩衝區,你須要查看剩餘的循環緩衝期:
radio
— 查看緩衝區的相關的信息.events
— 查看和事件相關的的緩衝區.main
— 查看主要的日誌緩衝區-b
選項使用方法:
[adb] logcat [-b <buffer>]
下面的例子表示怎麼查看日誌緩衝區包含radio 和 telephony信息:
adb logcat -b radio
在默認狀態下,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
可使用模擬器/設備上的默認設置
Option | Description |
---|---|
-b <buffer> |
加載一個可以使用的日誌緩衝區供查看,好比event 和radio . 默認值是main 。具體查看Viewing Alternative Log Buffers. |
-c |
清楚屏幕上的日誌. |
-d |
輸出日誌到屏幕上. |
-f <filename> |
指定輸出日誌信息的<filename> ,默認是stdout . |
-g |
輸出指定的日誌緩衝區,輸出後退出. |
-n <count> |
設置日誌的最大數目<count> .,默認值是4,須要和 -r 選項一塊兒使用。 |
-r <kbytes> |
每<kbytes> 時輸出日誌,默認值爲16,須要和-f 選項一塊兒使用. |
-s |
設置默認的過濾級別爲silent. |
-v <format> |
設置日誌輸入格式,默認的是brief 格式,要知道更多的支持的格式,參看Controlling Log Output Format . |
在某些狀況下,你可能須要終止Android 調試系統的運行,而後再從新啓動它。 例如,若是Android 調試系統不響應命令,你能夠先終止服務器而後再重啓,這樣就可能解決這個問題.
用kill-server
能夠終止adb server。你能夠用adb發出的任何命令來從新啓動服務器.