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 .