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 — Debugo I — Infoo W — Warningo E — Erroro F — Fatalo 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 BufferAndroid日志系统有多个循环缓冲区，并不是所有的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输出格式.

/////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////附，大家看两张在WORD里编辑的效果：一、开头

二、结尾