Android日志系統提供了記錄和查看系統調試信息的功能。日志都是從各種軟件和一些系統的緩沖區中記錄下來的,緩沖區可以通過 logcat
命 令來查看和使用.
使用logcat命令
你可以用 logcat
命令來查看系統日志緩沖區的內容:
請查看Listing of logcat Command Options ,它對logcat命 令有詳細的描述 .
你也可以在你的電腦或運行在模擬器/設備上的遠程adb shell端來使用logcat
命 令,也可以在你的電腦上查看日志輸出。
你也這樣使用:
# logcat過濾 日志輸出
每一個輸出的Android日志信息都有一個標簽和它的優先級.
- 日志的標簽是系統部件原始信息的一個簡要的標志。(比如:“View”就 是查看系統的標簽).
- 優先級有下列集中,是按照從低到高順利排列的:
V
— Verbose (lowest priority)D
— DebugI
— InfoW
— WarningE
— ErrorF
— FatalS
— 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
:輸入一個參數來設置默認的過濾
需要注意的是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
選 項來指定輸出格式:
下面是用 thread
來產生的日志格式:
需要注意的是你只能-v
選項來規定輸出格式 option.
查看 可用日志緩沖區
Android日志系統有循環緩沖區,並不是所有的日志系統都有默認循環緩沖區。為了得到 日志信息,你需要通過-b
選項來啟動logcat
。如果要使用循環緩沖區,你需要查看剩余的 循環緩沖期:
radio
— 查看緩沖區的相關的信息.events
— 查看和事件相關的的緩沖區.main
— 查看主要的日志緩沖區
-b
選項使用方法:
下面的例子表示怎么查看日志緩沖區包含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 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 .
1.eclipse的Debug模式或DDMS模式下的會有一個Logcat窗口,用於顯示log日志
只需在eclipse中啟動Android模擬器,切換到DDMS或debug模式下,就會有Logcat窗口,窗口右上方有一系列圖標,其中V、D、I、W、E五個圖標為五個調試信息過濾器:
V:不過濾輸出所有調試信息 包括 VERBOSE、DEBUG、INFO、WARN、ERROR
D:debug過濾器,輸出DEBUG、INFO、WARN、ERROR調試信息
I:info過濾器,輸出INFO、WARN、ERROR調試信息
W:waring過濾器,輸出WARN和ERROR調試信息
E:error過濾器,只輸出ERROR調試信息
2.Android命令模式下,在啟動一個模擬器是可以選擇是否需要啟動logcat:
Android Emulator命令的用法: emulator [options] [-qemu args]
1.Android Emulator命令的用法: emulator [options] [-qemu args]
啟動模擬器命令:emulator -avd <name> -logcat <tags>;
name:模擬器名字,tags調試信息過濾器類型
例如:emulator -avd GPhone -logcat w
啟動GPhone模擬器並運行logcat顯示調試信息,調試信息的過濾器是w(可替換為v、d、i、e),代表只顯示waring和error兩類調試信息。
2.Android adb 命令:adb logcat [ <filter-spec> ] - View device log
<filter-spec> == <priority>/<tag>,(pritrity標簽,tag為過濾類型)
例如:2.1、adb logcat 顯示所有調試信息
2.2、adb logcat *:w 顯示waring過濾器過濾后的調試信息
2.3、adb logcat Test1:V Test2:D 顯示標簽為Test1的所有調試信息,以及顯示標簽為Test2Debug過濾器過濾后的調試信息
3.Android程序中訪問調試日志,並顯示:
摘自:http://www.iteye.com/topic/477112
logcat介紹命令選項。
-s 默認設置過濾器
-f 輸出到日志文件
-c 清除日志
-d 獲取日志
-g 獲取日志的大小
-v 格式設置日志(見下面的格式打印格式)
-v 格式 例
brief W/tag ( 876): message
process W( 876) message (tag)
tag W/tag : message
thread W( 876:0x37c) message
raw message
time 09-08 05:40:26.729 W/tag ( 876): message
threadtime 09-08 05:40:26.729 876 892 W tag : message
long [ 09-08 05:40:26.729 876:0x37c W/tag ] message
代碼例子:
AndroidManifest.xml添加讀取權限
<uses-permission android:name="android.permission.READ_LOGS" />
清除日志
try {
Runtime.getRuntime().exec("logcat -c");
} catch(Exception e) {
獲取日志
try {
ArrayList<String> commandLine = new ArrayList<String>();
commandLine.add( "logcat");
commandLine.add( "-d");
commandLine.add( "-v");
commandLine.add( "time");
commandLine.add( "-s");
commandLine.add( "tag:W");
Process process = Runtime.getRuntime().exec( commandLine.toArray( new String[commandLine.size()]));
BufferedReader bufferedReader = new BufferedReader( new InputStreamReader(process.getInputStream()), 1024);
String line = bufferedReader.readLine();
while ( line != null) {
log.append(line);
log.append("\n")
}
} catch ( IOException e) {
}
結果:
09-08 09:44:42.267 W/tag ( 754): message1
09-08 09:44:42.709 W/tag ( 754): message2
09-08 09:44:43.187 W/tag ( 754): message3
09-08 09:44:45.295 E/tag ( 754): message8