负责人：lingzideshensha

原文链接：http://docs.eoeandroid.com/tools/debugging/debugging-log.html

Android测试系统提供一个机制来收集和观察系统调试输出。Logcat转储的系统日志消息,其中包括诸如当你写在你的应用程序通过使用日志类时，模拟器抛出一个错误和信息时的一些堆栈跟踪。你可以运行LogCat通过ADB或从DDMS，它允许你在实时读取消息。

日志是一个日志类,你可以利用在你的代码来打印出消息到LogCat。常见的日志记录方法包括：

比如：

Logcat就会打印出来像下面这些信息：

使用Logcat

你可以在DDMS内部使用Logcat，或者在adb shell 调用Logcat。如果想看更多关于如何在DDMS内部使用Logcat，可以使用DDMS。通常的用的方法是，通过adb shell命令运行Logcat。

你可以在你的开发计算机里面使用Locat命令，或者从一个远程adb shell在一个模拟器/设备。查看日志输出在你使用的开发计算机,。

如果是在远程shell中可直接使用命令：

下面的表描述了logcat命令行选项

清除整个日志信息 并退出。

打印日志到屏幕上 并退出。

指定输出日志信息的 ，默认是stdout

输出指定的日志缓冲区，输出后退出

设置日志输入格式，默认的是brief 格式，要知道更多的支持的格式，参看Controlling Log Output Format

设置日志的最大数目 .，默认值是4，需要和 -r 选项一起使用。

设置log文件的字节数 默认值是16kbytes, 需要一个 -f参数

设置默认的过滤级别为silent

过滤日志输出

每一个Android日志消息都有一个标签和一个与之关联的优先级。

• 标记的一个日志消息是一个短字符串，表明该系统组件的消息来源于（例如,“视图”的视图系统）；
  

• 下列优先级字符值，按从低到高排列。
  

通过运行logcat ，可以获得一个系统中使用的标记和优先级的列表，观察列表的前两列，给出的格式是/。

这里是一个日志输出的消息，优先级是“I”，标记是“ActivityManager”：

如果想要减少输出的内容，可以加上过滤器表达式进行限制，过滤器可以限制系统只输出感兴趣的标记-优先级组合。

过滤器表达式的格式是tag:priority ... ，其中tag是标记， priority是最小的优先级， 该标记标识的所有大于等于指定优先级的消息被写入日志。也可以在一个过滤器表达式中提供多个这样的过滤，它们之间用空格隔开。

下面给出的例子是仅输出标记为“ActivityManager”并且优先级大于等于“Info”和标记为“MyApp”并且优先级大于等于“Debug”的日志：

上述表达式最后的 * :S 用于设置所有标记的日志优先级为S，这样可以确保仅有标记为“View”（译者注：应该为ActivityManager，原文可能是笔误）和“MyApp”的日志被输出，使用 * :S 是可以确保输出符合指定的过滤器设置的一种推荐的方式，这样过滤器就成为了日志输出的“白名单”。

下面的表达是显示所有优先级大于等于“warning”的日志：

如果在开发用电脑上运行 logcat (相对于运行运程shell而言)，也可以通过ANDROID_LOG_TAGS环境变量设置默认的过滤器表达式：

需要注意的是，如果是在远程shell或是使用adb shell logcat 命令运行logcat ， ANDROID_LOG_TAGS 不会导出到模拟器或手机设备上。

控制日志格式

日志消息在标记和优先级之外��有很多元数据字段，这些字段可以通过修改输出格式来控制输出结果， -v 选项加上下面列出的内容可以控制输出字段：

:* brief — 显示优先级/标记和原始进程的PID (默认格式)
:* process — 仅显示进程PID
:* tag — 仅显示优先级/标记
:* thread — 仅显示进程：线程和优先级/标记
:* raw — 显示原始的日志信息，没有其他的元数据字段
:* time — 显示日期，调用时间，优先级/标记，PID
:* long —显示所有的元数据字段并且用空行分隔消息内容

可以使用 -v启动 logcat来控制日志格式：

例如使用 thread 输出格式：

注意只能在 -v 选项中指定一种格式。

Android日志系统为日志消息保持了多个循环缓冲区，而且不是所有的消息都被发送到默认缓冲区，要想查看这些附加的缓冲区，可以使用-b 选项，以下是可以指定的缓冲区：

-b 选项的用法：

例如查看radio缓冲区：

查看stdout和stderr

在默认状态下，Android系统有stdout 和 stderr (System.out和System.err ) 输出到/dev/null ， 在运行Dalvik VM的进程中，有一个系统可以备份日志文件。在这种情况下，系统会用stdout 和stderr 和 优先级来记录日志信息。

通过这种方法指定输出的路径，停止运行的模拟器/设备，然后通过用setprop 命 令远程 输入日志

系统直到你关闭模拟器/设备前设置会一直保留，可以通过添加/data/local.prop 可 以使用模拟器/设备上的默认设置。

调试Web应用程序

如果您正在开发一个web应用程序,Android,您可以调试您的JavaScript使用控制台的JavaScript api,它输出消息到logcat。有关更多信息,请参见Debugging Web Apps