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