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