android adb常用指令

文章目錄

• 通過遠程shell端運行sqllite3串連資料庫
• UI/軟體 實驗程式 Monkey
• 其它的shell命令
• 使用logcat命令
• 過濾日誌輸出
• 控制日誌輸出格式
• 查看可用日誌緩衝區
• 查看stdout 和stderr
• Logcat命令列表

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發出的任何命令來重新啟動伺服器.

 

轉載自：http://www.javaeye.com/topic/260042