Android adb常用指令使用指南

Android ADB(Android Debug Bridge)除錯橋是多種用途的工具，該工具可以幫助你你管理裝置或模擬器的狀態。

可以通過下列幾種方法加入adb:

• 在裝置上執行shell命令
• 通過埠轉發來管理模擬器或裝置
• 從模擬器或裝置上拷貝來或拷貝走檔案

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

1. 概要

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，比如說除錯.

2. 發出adb命令

發出Android命令： 你可以在你的開發機上的命令列或指令碼上釋出Android命令，使用方法:

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

當你發出一個命令，系統啟用Android客戶端。客戶端並不與模擬器例項相關，所以如果雙伺服器/裝置是執行中的，你需要用 -d 選項去為應被控制的命令確定目標例項。關於使用這個選項的更多資訊，可以檢視模擬器/裝置例項術語控制命令 .

3. 查詢模擬器/裝置例項

在釋出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  deviceemulator-5556  deviceemulator-5558  device

如果當前沒有模擬器/裝置執行，adb則返回 no device .

4. 給特定的模擬器/裝置例項傳送命令

如果有多個模擬器/裝置例項在執行，在釋出adb命令時需要指定一個目標例項。 這樣做，請使用-s 選項的命令。在使用的-s 選項是

adb -s <serialNumber> <command> 

如上所示，給一個命令指定了目標例項，這個目標例項使用由adb分配的序列號。你可以使用 devices 命令來獲得執行著的模擬器/裝置例項的序列號

示例如下:

adb -s emulator-5556 install helloWorld.apk

注意這點，如果沒有指定一個目標模擬器/裝置例項就執行 -s 這個命令的話，adb會產生一個錯誤.

5.  安裝軟體

你可以使用adb從你的開發電腦上覆制一個應用程式，並且將其安裝在一個模擬器/裝置例項。像這樣做，使用install 命令。這個install 命令要求你必須指定你所要安裝的.apk檔案的路徑:

adb install <path_to_apk>

為了獲取更多的關於怎樣建立一個可以安裝在模擬器/裝置例項上的.apk檔案的資訊，可參照Android Asset Packaging Tool (aapt).

要注意的是，如果你正在使用Eclipse IDE並且已經安裝過ADT外掛，那麼就不需要直接使用adb（或者aapt）去安裝模擬器/裝置上的應用程式。否則，ADT外掛代你全權處理應用程式的打包和安裝.

6. 轉發埠

adb forward tcp:6100 tcp:7100

同樣地，可以使用adb來建立命名為抽象的UNIX域套介面，上述過程如下所示:

adb forward tcp:6100 local:logd 

7. 從模擬器/裝置中拷入或拷出文件

可以使用adbpull ,push 命令將檔案複製到一個模擬器/裝置例項的資料檔案或是從資料檔案中複製。install 命令只將一個.apk檔案複製到一個特定的位置，與其不同的是，pull 和 push 命令可令你複製任意的目錄和檔案到一個模擬器/裝置例項的任何位置。

從模擬器或者裝置中複製檔案或目錄，使用(如下命):

adb pull <remote> <local>

將檔案或目錄複製到模擬器或者裝置，使用（如下命令）

adb push <local> <remote>

在這些命令中， <local> 和<remote> 分別指通向自己的發展機（本地）和模擬器/裝置例項（遠端）上的目標檔案/目錄的路徑


下面是一個例子：:

adb push foo.txt /sdcard/foo.txt

8. Adb命令列表

下列表格列出了adb支援的所有命令, 並對它們的意義和使用方法做了說明：

adb wait-for-device shell getprop

adb wait-for-device install <app>.apk

9. 啟動shell命令

不管你是否完全進入到模擬器/裝置的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命令的知識.

10. 通過遠端shell端執行sqllite3連線資料庫

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

文件頁面

其它的shell命令

adb shell ls /system/bin

對大部分命令來說，help都是可用的.

啟用logcat日誌

使用logcat命令

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

請檢視Listing of logcat Command Options ，它對logcat命令有詳細的描述 .
你也可以在你的電腦或執行在模擬器/裝置上的遠端adb shell端來使用logcat 命令，也可以在你的電腦上檢視日誌輸出。
$ adb logcat
你也這樣使用：
# logcat

過濾日誌輸出

• V — Verbose (lowest priority)
• D — Debug
• I — Info
• W — Warning
• E — Error
• F — Fatal
• S — Silent (highest priority, on which nothing is ever printed)

<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 來執行模擬器/裝置不能輸出日誌.

控制日誌輸出格式

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

檢視可用日誌緩衝區

• radio — 檢視緩衝區的相關的資訊.
• events — 檢視和事件相關的的緩衝區.
• main — 檢視主要的日誌緩衝區

-b 選項使用方法:
[adb] logcat [-b <buffer>]

下面的例子表示怎麼檢視日誌緩衝區包含radio 和 telephony資訊:
adb logcat -b radio

檢視stdout 和stderr

系統直到你關閉模擬器/裝置前設定會一直保留，可以通過新增/data/local.prop 可以使用模擬器/裝置上的預設設定

Logcat命令列表

Stopping the adb Server