Android 調試橋

Android 調試橋(adb)是多種用途的工具，該工具能夠幫助你你管理設備或模擬器 的狀態。

能夠經過下列幾種方法加入adb:

• 在設備上運行shell命令
• 經過端口轉發來管理模擬器或設備
• 從模擬器或設備上拷貝來或拷貝走文件

下面對adb進行了介紹並描述了常見的使用.

Contents

概要 發出adb命令 查詢模擬器/設備實例 給特定的模擬器/設備實例發送命令 安裝軟件 轉發端口 從模擬器/設備中拷入或拷出文件 Adb命令列表 啓動shell命令 經過遠程shell端運行sqllite3鏈接數據庫 UI/軟件 試驗程序 Monkey 其它的shell命令 啓用logcat日誌 使用logcat命令 過濾日誌輸出 控制日誌輸出格式 查看可用日誌緩衝區 查看stdout 和stderr Logcat命令列表 中止adb服務

概要

Android 調試系統是一個面對客戶服務系統，包括三個組成部分:

• 一個在你用於開發程序的電腦上運行的客戶端。你能夠經過shell端使用adb命令啓動客戶端。 其餘Android工具好比說ADT插件和DDMS一樣能夠產生adb客戶端.
• 在你用於發的機器上做爲後臺進程運行的服務器。該服務器負責管理客戶端與運行於模擬器或設備上的adb守護程序(daemon)之間的通訊。.
• 一個之後臺進程的形式運行於模擬器或設備上的守護程序(daemon)。.

當你啓動一個adb客戶端，客戶端首先確認是否已有一個adb服務進程在運行。若是沒有，則啓動服務進程。當服務器運行， adb服務器就會綁定本地的TCP端口5037並監聽adb客戶端發來的命令，—全部的adb客戶端都是用端口 5037與adb服務器對話的.

接着服務器將全部運行中的模擬器或設備實例創建鏈接。它經過掃描全部5555到5585範圍內的奇數端口來定位全部的模擬器或設備。一旦服務器找到了adb守護程序，它將創建一個到該端口的鏈接。請注意任何模擬器或設備實例會取得兩個連續的端口——一個偶數端口用來相應控制檯的鏈接，和一個奇數端口用來響應adb鏈接。好比說:

模擬器1，控制檯：端口5554
模擬器1，Adb端口5555
控制檯：端口 5556
Adb端口5557...

如上所示，模擬器實例經過5555端口鏈接adb，就如同使用5554端口鏈接控制檯同樣.

一旦服務器與全部模擬器實例創建鏈接，就可使用adb命令控制和訪問該實例。由於服務器管理模擬器/設備實例的鏈接，和控制處理歷來自多個adb客戶端來的命令，你能夠經過任何客戶端(或腳本)來控制任何模擬器或設備實例.

如下的部分描述經過命令使用adb和管理模擬器/設備的狀態。要注意的是若是你用，裝有ADT插件的Eclipse開發Android程序，你就不須要經過命令行使用adb。ADT插件已經透明的把adb集成到Eclipse中了，固然，若是必要的話你也能夠仍然直接使用adb，好比說調試.

發出adb命令

發出Android命令：你能夠在你的開發機上的命令行或腳本上發佈Android命令，使用方法:

adb [-d|-e|-s <serialNumber>] <command>

當你發出一個命令，系統啓用Android客戶端。客戶端並不與模擬器實例相關，因此若是雙服務器/設備是運行中的，你須要用 -d 選項去爲應被控制的命令肯定目標實例。關於使用這個選項的更多信息，能夠查看模擬器/設備實例術語控制命令 .

查詢模擬器/設備實例

在發佈adb命令以前，有必要知道什麼樣的模擬器/設備實例與adb服務器是相連的。能夠經過使用devices 命令來獲得一系列相關聯的模擬器/設備:

adb devices

• 做爲迴應，adb爲每一個實例都制定了相應的狀態信息:

• • 序列號——由adb建立的一個字符串，這個字符串經過本身的控制端口<type>-<consolePort> 惟一地識別一個模擬器/設備實例。下面是一個序列號的例子： emulator-5554
• 實例的鏈接狀態有三種狀態:
  • offline — 此實例沒有與adb相鏈接或者沒法響應.
  • device — 此實例正與adb服務器鏈接。注意這個狀態並不能百分之百地表示在運行和操做Android系統，所以這個實例是當系統正在運行的時候與adb鏈接的。然而，在系統啓動以後，就是一個模擬器/設備狀態的正常運行狀態了.

每一個實例的輸出都有以下固定的格式:

[serialNumber] [state]

下面是一個展現devices 命令和輸出的例子 :

$ adb devices
List of devices attached 
emulator-5554  device
emulator-5556  device
emulator-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命令列表

下列表格列出了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方法遠程鏈接模擬器/設施	端口須要描述下列信息: tcp:<portnum> local:<UNIX domain socket name> dev:<character device name> jdwp:<pid>
ppp <tty> [parm]...	經過USB運行ppp： <tty> — the tty for PPP stream. For exampledev:/dev/omap_csmi_ttyl . [parm]... &mdash zero or more PPP/PPPD options, such as defaultroute , local , notty , etc. 須要提醒你的不能自動啓動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.

啓動shell命令

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命令的知識.

經過遠程shell端運行sqllite3鏈接數據庫

經過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.db
SQLite version 3.3.12
Enter ".help" for instructions .... enter commands, then quit... sqlite> .exit

當你啓動sqlite3的時候，你就能夠經過shell端發送 sqlite3 ,命令了。用exit 或 CTRL+D 退出adb遠程shell端.

UI/軟件 試驗程序 Monkey

當Monkey程序在模擬器或設備運行的時候，若是用戶出發了好比點擊，觸摸，手勢或一些系統級別的事件的時候，它就會產生隨機脈衝，因此能夠用Monkey用隨機重複的方法去負荷測試你開發的軟件.

最簡單的方法就是用用下面的命令來使用Monkey，這個命令將會啓動你的軟件而且觸發500個事件.

$ adb shell monkey -v -p your.package.name 500

更多的關於命令Monkey的命令的信息，能夠查看UI/Application Exerciser Monkey documentation page.

文檔頁面

其它的shell命令

下面的表格列出了一些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	關閉一個模擬器/設備實例.

啓用logcat日誌

Android日誌系統提供了記錄和查看系統調試信息的功能。日誌都是從各類軟件和一些系統的緩衝區中記錄下來的，緩衝區能夠經過 logcat 命令來查看和使用.

使用logcat命令

你能夠用 logcat 命令來查看系統日誌緩衝區的內容:

[adb] logcat [<option>] ... [<filter-spec>] ...

請查看Listing of logcat Command Options ，它對logcat命令有詳細的描述 .

你也能夠在你的電腦或運行在模擬器/設備上的遠程adb shell端來使用logcat 命令，也能夠在你的電腦上查看日誌輸出。

$ adb logcat

你也這樣使用：

# logcat

過濾日誌輸出

每個輸出的Android日誌信息都有一個標籤和它的優先級.

• 日誌的標籤是系統部件原始信息的一個簡要的標誌。（好比：「View」就是查看系統的標籤）.
• 優先級有下列集中，是按照從低到高順利排列的:
  • V — Verbose (lowest priority)
  • D — Debug
  • I — Info
  • W — Warning
  • E — Error
  • F — Fatal
  • S — 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

查看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命令列表

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 .

Stopping the adb Server

在某些狀況下，你可能須要終止Android 調試系統的運行,而後再從新啓動它。例如,若是Android 調試系統不響應命令，你能夠先終止服務器而後再重啓，這樣就可能解決這個問題.

用kill-server 能夠終止adb server。你能夠用adb發出的任何命令來從新啓動服務器.