轉： android的logcat詳細用法

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