Android 調試橋(adb)是多種用途的工具,該工具可以幫助你你管理裝置或模拟器 的狀态。
可以通過下列幾種方法加入adb:
在裝置上運作shell指令
通過端口轉發來管理模拟器或裝置
從模拟器或裝置上拷貝來或拷貝走檔案
下面對adb進行了介紹并描述了常見的使用.
<dl></dl>
<dt>概要</dt>
<dt>發出adb指令</dt>
<dt>查詢模拟器/裝置執行個體</dt>
<dt>給特定的模拟器/裝置執行個體發送指令</dt>
<dt>安裝軟體</dt>
<dt>轉發端口</dt>
<dt>從模拟器/裝置中拷入或拷出檔案</dt>
<dt>Adb指令清單</dt>
<dt>啟動shell指令</dt>
<dd>通過遠端shell端運作sqllite3連接配接資料庫</dd>
<dd>UI/軟體 試驗程式 Monkey</dd>
<dd>其它的shell指令</dd>
<dt>啟用logcat日志</dt>
<dd>使用logcat指令</dd>
<dd>過濾日志輸出</dd>
<dd>控制日志輸出格式</dd>
<dd>檢視可用日志緩沖區</dd>
<dd>檢視stdout 和stderr</dd>
<dd>Logcat指令清單</dd>
<dt>停止adb服務</dt>
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,比如說調試.
發出Android指令: 你可以在你的開發機上的指令行或腳本上釋出Android指令,使用方法:
當你發出一個指令,系統啟用Android用戶端。用戶端并不與模拟器執行個體相關,是以如果雙伺服器/裝置是運作中的,你需要用 <code>-d</code> 選項去為應被控制的指令确定目标執行個體。關于使用這個選項的更多資訊,可以檢視模拟器/裝置執行個體術語控制指令 .
在釋出adb指令之前,有必要知道什麼樣的模拟器/裝置執行個體與adb伺服器是相連的。可以通過使用<code>devices</code> 指令來得到一系列相關聯的模拟器/裝置:
•作為回應,adb為每個執行個體都制定了相應的狀态資訊:
•序列号——由adb建立的一個字元串,這個字元串通過自己的控制端口<code><type>-<consolePort></code> 唯一地識别一個模拟器/裝置執行個體。下面是一個序列号的例子: <code>emulator-5554</code>
執行個體的連接配接狀态有三種狀态:
<code>offline</code> — 此執行個體沒有與adb相連接配接或者無法響應.
<code>device</code> — 此執行個體正與adb伺服器連接配接。注意這個狀态并不能百分之百地表示在運作和操作Android系統,是以這個執行個體是當系統正在運作的時候與adb連接配接的。然而,在系統啟動之後,就是一個模拟器/裝置狀态的正常運作狀态了.
每個執行個體的輸出都有如下固定的格式:
下面是一個展示<code>devices</code> 指令和輸出的例子 :
如果目前沒有模拟器/裝置運作,adb則傳回 <code>no device</code> .
如果有多個模拟器/裝置執行個體在運作,在釋出adb指令時需要指定一個目标執行個體。這樣做,請使用<code>-s</code> 選項的指令。在使用的<code>-s</code> 選項是
如上所示,給一個指令指定了目标執行個體,這個目标執行個體使用由adb配置設定的序列号。你可以使用 <code>devices</code> 指令來獲得運作着的模拟器/裝置執行個體的序列号
示例如下:
注意這點,如果沒有指定一個目标模拟器/裝置執行個體就執行 <code>-s</code> 這個指令的話,adb會産生一個錯誤.
你可以使用adb從你的開發電腦上複制一個應用程式,并且将其安裝在一個模拟器/裝置執行個體。像這樣做,使用<code>install</code> 指令。這個<code>install</code> 指令要求你必須指定你所要安裝的.apk檔案的路徑:
為了擷取更多的關于怎樣建立一個可以安裝在模拟器/裝置執行個體上的.apk檔案的資訊,可參照Android Asset Packaging Tool (aapt).
要注意的是,如果你正在使用Eclipse IDE并且已經安裝過ADT插件,那麼就不需要直接使用adb(或者aapt)去安裝模拟器/裝置上的應用程式。否則,ADT插件代你全權處理應用程式的打包和安裝.
可以使用 <code>forward</code> 指令進行任意端口的轉發——一個模拟器/裝置執行個體的某一特定主機端口向另一不同端口的轉發請求。下面示範了如何建立從主機端口6100到模拟器/裝置端口7100的轉發。
同樣地,可以使用adb來建立命名為抽象的UNIX域套接口,上述過程如下所示:
可以使用adb<code>pull</code> ,<code>push</code> 指令将檔案複制到一個模拟器/裝置執行個體的資料檔案或是從資料檔案中複制。<code>install</code> 指令隻将一個.apk檔案複制到一個特定的位置,與其不同的是,<code>pull</code> 和 <code>push</code> 指令可令你複制任意的目錄和檔案到一個模拟器/裝置執行個體的任何位置。
從模拟器或者裝置中複制檔案或目錄,使用(如下命):
将檔案或目錄複制到模拟器或者裝置,使用(如下指令)
在這些指令中, <code><local></code> 和<code><remote></code> 分别指通向自己的發展機(本地)和模拟器/裝置執行個體(遠端)上的目标檔案/目錄的路徑
下面是一個例子::
下清單格列出了adb支援的所有指令,并對它們的意義和使用方法做了說明.
Category
Command
Description
Comments
Options
<code>-d</code>
僅僅通過USB接口來管理abd.
如果不隻是用USB接口來管理則傳回錯誤.
<code>-e</code>
僅僅通過模拟器執行個體來管理adb.
如果不是僅僅通過模拟器執行個體管理則傳回錯誤.
<code>-s <serialNumber></code>
通過模拟器/裝置的允許的指令号碼來發送指令來管理adb (比如: "emulator-5556").
如果沒有指定号碼,則會報錯.
General
<code>devices</code>
檢視所有連接配接模拟器/裝置的設施的清單.
檢視 Querying for Emulator/Device Instances擷取更多相關資訊.
<code>help</code>
檢視adb所支援的所有指令。.
<code>version</code>
檢視adb的版本序列号.
Debug
<code>logcat [<option>] [<filter-specs>]</code>
将日志資料輸出到螢幕上.
<code>bugreport</code>
檢視bug的報告,如<code>dumpsys</code> ,<code>dumpstate</code> ,和<code>logcat</code> 資訊。
<code>jdwp</code>
檢視指定的設施的可用的JDWP資訊.
可以用 <code>forward jdwp:<pid></code> 端口映射資訊來連接配接指定的JDWP程序.例如:
<code>adb forward tcp:8000 jdwp:472</code>
<code>jdb -attach localhost:8000</code>
Data
<code>install <path-to-apk></code>
安裝Android為(可以模拟器/設施的資料檔案.apk指定完整的路徑).
<code>pull <remote> <local></code>
将指定的檔案從模拟器/設施的拷貝到電腦上.
<code>push <local> <remote></code>
将指定的檔案從電腦上拷貝到模拟器/裝置中.
Ports and Networking
<code>forward <local> <remote></code>
用本地指定的端口通過socket方法遠端連接配接模拟器/設施
端口需要描述下列資訊:
<code>tcp:<portnum></code>
<code>local:<UNIX domain socket name></code>
<code>dev:<character device name></code>
<code>jdwp:<pid></code>
<code>ppp <tty> [parm]...</code>
通過USB運作ppp:
<code><tty></code> — the tty for PPP stream. For example<code>dev:/dev/omap_csmi_ttyl</code>.
<code>[parm]...</code> &mdash zero or more PPP/PPPD options, such as <code>defaultroute</code> ,<code>local</code> , <code>notty</code> , etc.
需要提醒你的不能自動啟動PDP連接配接.
Scripting
<code>get-serialno</code>
檢視adb執行個體的序列号.
檢視 Querying for Emulator/Device Instances可以獲得更多資訊.
<code>get-state</code>
檢視模拟器/設施的目前狀态.
<code>wait-for-device</code>
如果裝置不聯機就不讓執行,--也就是執行個體狀态是 <code>device</code> 時.
你可以提前把指令轉載在adb的指令器中,在指令器中的指令在模拟器/裝置連接配接之前是不會執行其它指令的. 示例如下:
需要提醒的是這些指令在所有的系統啟動啟動起來之前是不會啟動adb的 是以在所有的系統啟動起來之前你也不能執行其它的指令. 比如:運用<code>install</code> 的時候就需要Android包,這些包隻有系統完全啟動。例如:
上面的指令隻有連接配接上了模拟器/裝置連接配接上了adb服務才會被執行,而在Android系統完全啟動前執行就會有錯誤發生.
Server
<code>start-server</code>
選擇服務是否啟動adb服務程序.
<code>kill-server</code>
終止adb服務程序.
Shell
<code>shell</code>
通過遠端shell指令來控制模拟器/裝置執行個體.
檢視 擷取更多資訊 for more information.
<code>shell [<shellCommand>]</code>
連接配接模拟器/設施執行shell指令,執行完畢後退出遠端shell端l.
Adb 提供了shell端,通過shell端你可以在模拟器或裝置上運作各種指令。這些指令以2進制的形式儲存在本地的模拟器或裝置的檔案系統中:
不管你是否完全進入到模拟器/裝置的adb遠端shell端,你都能 <code>shell</code> 指令來執行指令.
當沒有完全進入到遠端shell的時候,這樣使用<code>shell</code> 指令來執行一條指令:
在模拟器/裝置中不用遠端shell端時,這樣使用<code>shell</code> 命 :
通過操作<code>CTRL+D</code> 或<code>exit</code> 就可以退出shell遠端連接配接.
下面一些就将告訴你更多的關于shell指令的知識.
通過adb遠端shell端,你可以通過Android軟sqlite3 指令程式來管理資料庫。<code>sqlite3</code> 工具包含了許多使用指令,比如:<code>.dump</code> 顯示表的内容,<code>.schema</code> 可以顯示出已經存在的表空間的SQL CREATE結果集。Sqlite3還允許你遠端執行sql指令.
通過<code>sqlite3</code> , 按照前幾節的方法登陸模拟器的遠端shell端,然後啟動工具就可以使用<code>sqlite3</code> 指令。當<code>sqlite3</code> 啟動以後,你還可以指定你想檢視的資料庫的完整路徑。模拟器/裝置執行個體會在檔案夾中儲存SQLite3資料庫. <code>/data/data/<package_name>/databases/</code> .
當你啟動sqlite3的時候,你就可以通過shell端發送 <code>sqlite3</code> ,指令了。用<code>exit</code> 或 <code>CTRL+D</code> 退出adb遠端shell端.
當Monkey程式在模拟器或裝置運作的時候,如果使用者出發了比如點選,觸摸,手勢或一些系統級别的事件的時候,它就會産生随機脈沖,是以可以用Monkey用随機重複的方法去負荷測試你開發的軟體.
最簡單的方法就是用用下面的指令來使用Monkey,這個指令将會啟動你的軟體并且觸發500個事件.
更多的關于指令Monkey的指令的資訊,可以檢視UI/Application Exerciser Monkey documentation page.
文檔頁面
下面的表格列出了一些adbshell指令,如果需要全部的指令和程式,可以啟動模拟器執行個體并且用<code>adb -help</code> 指令 .
對大部門指令來說,help都是可用的.
Shell Command
<code>dumpsys</code>
清除螢幕中的系統資料n.
Dalvik Debug Monitor Service (DDMS)工具提供了完整的調試、.
<code>dumpstate</code>
清除一個檔案的狀态.
<code>logcat [<option>]... [<filter-spec>]...</code>
啟動資訊日志并且但因輸出到螢幕上.
<code>dmesg</code>
輸出主要的調試資訊到螢幕上.
<code>start</code>
啟動或重新開機一個模拟器/裝置執行個體.
<code>stop</code>
關閉一個模拟器/裝置執行個體.
Android日志系統提供了記錄和檢視系統調試資訊的功能。日志都是從各種軟體和一些系統的緩沖區中記錄下來的,緩沖區可以通過 <code>logcat</code> 指令來檢視和使用.
你可以用 <code>logcat</code> 指令來檢視系統日志緩沖區的内容:
請檢視Listing of logcat Command Options ,它對logcat指令有詳細的描述 .
你也可以在你的電腦或運作在模拟器/裝置上的遠端adb shell端來使用<code>logcat</code> 指令,也可以在你的電腦上檢視日志輸出。
你也這樣使用:
每一個輸出的Android日志資訊都有一個标簽和它的優先級.
日志的标簽是系統部件原始資訊的一個簡要的标志。(比如:“View”就是檢視系統的标簽).
優先級有下列集中,是按照從低到高順利排列的:
<code>V</code> — Verbose (lowest priority)
<code>D</code> — Debug
<code>I</code> — Info
<code>W</code> — Warning
<code>E</code> — Error
<code>F</code> — Fatal
<code>S</code> — Silent (highest priority, on which nothing is ever printed)
在運作logcat的時候在前兩列的資訊中你就可以看到 <code>logcat</code> 的标簽清單和優先級别,它是這樣标出的:<code><priority>/<tag></code> .
下面是一個logcat輸出的例子,它的優先級就似乎I,标簽就是ActivityManage:
為了讓日志輸出能展現管理的級别,你還可以用過濾器來控制日志輸出,過濾器可以幫助你描述系統的标簽等級.
過濾器語句按照下面的格式描<code>tag:priority ...</code> , <code>tag</code> 表示是标簽, <code>priority</code> 是表示标簽的報告的最低等級. 從上面的tag的中可以得到日志的優先級. 你可以在過濾器中多次寫<code>tag:priority</code> .
這些說明都隻到空白結束。下面有一個列子,例子表示支援所有的日志資訊,除了那些标簽為”ActivityManager”和優先級為”Info”以上的和标簽為” MyApp”和優先級為” Debug”以上的。 小等級,優先權報告為tag.
上面表達式的最後的元素 <code>*:S</code> ,,是設定所有的标簽為"silent",所有日志隻顯示有"View" and "MyApp"的,用 <code>*:S</code> 的另一個用處是能夠確定日志輸出的時候是按照過濾器的說明限制的,也讓過濾器也作為一項輸出到日志中.
下面的過濾語句指顯示優先級為warning或更高的日志資訊:
如果你電腦上運作<code>logcat</code> ,相比在遠端adbshell端,你還可以為環境變量<code>ANDROID_LOG_TAGS</code> :輸入一個參數來設定預設的過濾
需要注意的是<code>ANDROID_LOG_TAGS</code> 過濾器如果通過遠端shell運作<code>logcat</code> 或用<code>adb shell logcat</code> 來運作模拟器/裝置不能輸出日志.
日志資訊包括了許多中繼資料域包括标簽和優先級。可以修改日志的輸出格式,是以可以顯示出特定的中繼資料域。可以通過 <code>-v</code> 選項得到格式化輸出日志的相關資訊.
<code>brief</code> — Display priority/tag and PID of originating process (the default format).
<code>process</code> — Display PID only.
<code>tag</code> — Display the priority/tag only.
<code>thread</code> — Display process:thread and priority/tag only.
<code>raw</code> — Display the raw log message, with no other metadata fields.
<code>time</code> — Display the date, invocation time, priority/tag, and PID of the originating process.
<code>long</code> — Display all metadata fields and separate messages with a blank lines.
當啟動了<code>logcat</code> ,你可以通過<code>-v</code> 選項來指定輸出格式:
下面是用 <code>thread</code> 來産生的日志格式:
需要注意的是你隻能<code>-v</code> 選項來規定輸出格式 option.
Android日志系統有循環緩沖區,并不是所有的日志系統都有預設循環緩沖區。為了得到日志資訊,你需要通過<code>-b</code> 選項來啟動<code>logcat</code> 。如果要使用循環緩沖區,你需要檢視剩餘的循環緩沖期:
<code>radio</code> — 檢視緩沖區的相關的資訊.
<code>events</code> — 檢視和事件相關的的緩沖區.
<code>main</code> — 檢視主要的日志緩沖區
<code>-b</code> 選項使用方法:
下面的例子表示怎麼檢視日志緩沖區包含radio 和 telephony資訊:
在預設狀态下,Android系統有<code>stdout</code> 和 <code>stderr</code> (<code>System.out</code> 和<code>System.err</code> )輸出到<code>/dev/null</code> ,在運作Dalvik VM的程序中,有一個系統可以備份日志檔案。在這種情況下,系統會用<code>stdout</code> 和<code>stderr</code> 和優先級 I.來記錄日志資訊
通過這種方法指定輸出的路徑,停止運作的模拟器/裝置,然後通過用 <code>setprop</code> 指令遠端輸入日志
系統直到你關閉模拟器/裝置前設定會一直保留,可以通過添加<code>/data/local.prop</code> 可以使用模拟器/裝置上的預設設定
Logcat指令清單
在某些情況下,你可能需要終止Android 調試系統的運作,然後再重新啟動它。 例如,如果Android 調試系統不響應指令,你可以先終止伺服器然後再重新開機,這樣就可能解決這個問題.
用<code>kill-server</code> 可以終止adb server。你可以用adb發出的任何指令來重新啟動伺服器.