Android的Logcat命令详解：翻译Enabling logcat Logging

Android LOG系统提供了收集和查看系统调试输出的功能。各种应用程序和系统其他部分输出的LOG都存储在一些循环缓冲区里，这些缓冲区可以通过 logcat 命令来查看和过滤使用。

使用logcat命令

你可以用 logcat 命令来查看和控制系统LOG Buffer里内容，通常用法：

[adb] logcat [<option>] ... [<filter-spec>] ...

这节下面内容解释过滤以及命令的选项。关于选项的全面总结可参看：logcat命令选项列表

你可以在你的电脑，也可以通过运行在模拟器/设备上的远程adb shell端来使用logcat命令。在你的电脑上查看LOG输出：

$ adb logcat

通过远端 adb shell，可以这样：

# logcat

过滤Log输出

Android LOG信息都有一个标签（tag）和它的优先级（priority）。

·         LOG的标签是一个简短的描述来指示发生在哪一个系统部件内，在写LOG时指定。（比如：“View”就是查看VIEW系统的标签）.

·         优先级有下列几种，按照优先级从低到高顺序排列为：

o    V — Verbose (最低优先级)

o    D — Debug

o    I — Info

o    W — Warning

o    E — Error

o    F — Fatal

o    S — Silent (最高优先级，没有任何输出)

在运行logcat 的时候在前两列的信息中你就可以看到 logcat 的标签列表和优先级别,它是这样标出的<priority>/<tag>.

下面是一个logcat输出的例子,它的优先级就是“I”，标签是“ActivityManage”：

I/ActivityManager(  585): Starting activity: Intent { action=android.intent.action...}

为了让LOG输出达到可管理的级别，你还可以用过滤器来限制LOG输出，过滤器可以帮助只是显示你感兴趣的tag-priority组合的信息，而隐藏其他信息。

A过滤器语句按照tag:priority ...格式描述。这里，tag 表示是感兴趣的标签，priority 是表示报告指定标签的最低等级。 包含上面tag的信息或者指定优先级之上的信息被写入LOG。你可以在一个过滤表达式中提供多个tag:priority 声明，这些声明之间用空白符间隔。

下面有一个过滤表达式的例子，例子表示不显示其他所有的LOG信息，除了那些标签为“ActivityManager”且优先级为“Info”以上的和标签为“ MyApp”且优先级为“ Debug”以上的信息。

adb logcat ActivityManager:I MyApp:D *:S

上面表达式的最后的元素 *:S,，是设置所有标签的优先级为“silent”，这样保证只有“View”和“MyApp”的LOG才会显示。用 *:S 的是确保日志输出被限制在你明确指定的过滤表达式的极好方法——它使的你的过滤器在LOG输出时就像一个“白名单”。

下面过滤语句显示优先级为warning或更高的LOG日志信息：

adb logcat *:W

如果你在电脑上运行logcat （相比远程运行adb shell），你还可以通过为环境变量ANDROID_LOG_TAGS指定一个参数来设置缺省的过滤器：

export ANDROID_LOG_TAGS="ActivityManager:I MyApp:D *:S"

需要注意，如果你从远端运行logcat 或者使用adb shell logcat，ANDROID_LOG_TAGS 过滤器并不能应用在模拟器/设备实例上 。

控制LOG输出格式

Log日志信息除了包括标签和优先级外，还有许多其他元数据域。可以修改日志的输出格式，来显示出特定的元数据域。可以通过-v 选项来指定下列所支持的格式化输出。

·         brief — 显示priority/tag和打印LOG进程的PID（(缺省格式)。

·         process — 仅仅显示PID。.

·         tag — 仅仅显示priority/tag。

·         thread — 显示进程:线程和priority/tag.

·         raw — 显示原始LOG信息，不显示其他元数据域。

·         time — 显示日期，发生时间，priority/tag和打印LOG进程的PID。

·         long — 显示所有的元数据域和LOG信息，他们之间用空白行隔开。

当启动了logcat，你可以通过-v选项来指定输出格式：

[adb] logcat [-v <format>]

下面是用 thread 输出格式来产生的LOG的例子：

adb logcat -v thread

要注意的是你只能用-v 选项来指定一个输出格式。

查看指定的LOG Buffer

Android日志系统有多个循环缓冲区，并不是所有的LOG信息都把LOG输出到默认循环缓冲区。为了看到其他缓冲区的LOG信息，你需要通过-b 选项来启动logcat 。来看其他循环缓冲区。这些缓冲区有：

·         radio — 查看与无线/电话相关的缓冲区里的信息。

·         events — 查看和事件相关的的缓冲区。

·         main — 查看main缓冲区里的LOG (缺省)

-b  选项使用方法：

[adb] logcat [-b <buffer>]

下面的例子演示怎么查看包含radio 和 telephony信息的LOG缓冲区：

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命令选项列表

选项	描述
-b <buffer>	加载一个指定的LOG Buffer供查看，比如event 或radio。 默认值是main 。具体参考查看指定的Log Buffers.
-c	清除整个 log并退出。
-d	输出LOG到屏幕上并退出。
-f <filename>	写LOG信息到 <filename>。默认是stdout.
-g	打印指定LOG Buffer的大小并退出。
-n <count>	设置日志的最大数目<count>，默认值是4，需要和选项-r一起使用。
-r <kbytes>	Rotates每输出<kbytes> 写LOG文件，默认值为16，需要和选项-f一起使用。
-s	设置默认的过滤级别为silent。
-v <format>	Sets 设置LOG的输出格式，默认的是brief 格式，要知道更多的支持的格式，参看控制LOG输出格式.