Android開發環境搭建之Android 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

· 實例的鏈接狀態有三種狀態:

o offline — 此實例沒有與adb相鏈接或者沒法響應.

o 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 example dev:/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」就是查看系統的標籤）.

· 優先級有下列集中，是按照從低到高順利排列的:

o V — Verbose (lowest priority)

o D — Debug

o I — Info

o W — Warning

o E — Error

o F — Fatal

o 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 .