文章目錄
- 通過遠程shell端運行sqllite3串連資料庫
- UI/軟體 實驗程式 Monkey
- 其它的shell命令
- 使用logcat命令
- 過濾日誌輸出
- 控制日誌輸出格式
- 查看可用日誌緩衝區
- 查看stdout 和stderr
- Logcat命令列表
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 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命令列表
下列表格列出了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.dbSQLite version 3.3.12Enter ".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發出的任何命令來重新啟動伺服器.