Android日志[进阶篇]一-使用 Logcat 写入和查看日志
Android日志[进阶篇]二-分析堆栈轨迹(调试和外部堆栈)
Android日志[进阶篇]三-Logcat命令行工具
Android日志[进阶篇]四-获取错误报告
Android日志[进阶篇]五-阅读错误报告
目录
日志记录系统概览命令行语法logcat命令行选项过滤日志输出控制日志输出格式格式修饰符查看备用日志缓冲区通过代码记录日志前言:平常用logcat看日志或copy日志,实际是在logcat的一个可视化窗口上进行简单的read和copy,这个窗口是由logcat工具支撑的,并不是logcat的全部。
Logcat 是一个命令行工具,用于转储系统消息日志,包括设备抛出错误时的堆栈轨迹,以及App使用Log
类写入的消息。
本文介绍了命令行 Logcat 工具,但在 Android Studio 中,可以从Logcat窗口查看日志消息。如需了解如何在 Android Studio 中查看和过滤日志,请参阅Android日志[进阶篇]一-使用 Logcat 写入和查看日志。
日志记录系统概览
Android 日志记录系统是系统进程logd
维护的一组结构化环形缓冲区。这组可用的缓冲区是固定的,并由系统定义。最相关的缓冲区为:main
(用于存储大多数应用日志)、system
(用于存储源自 Android 操作系统的消息)和crash
(用于存储崩溃日志)。每个日志条目都包含一个优先级(VERBOSE
、DEBUG
、INFO
、WARNING
、ERROR
或FATAL
)、一个标识日志来源的标记以及实际的日志消息。
日志记录系统的主接口是共享库liblog
及其头文件<android/log.h>
。所有语言特定的日志记录工具最终都会调用函数__android_log_write
。默认情况下,它会调用函数__android_log_logd_logger
,该函数使用套接字将日志条目发送到logd
。从 API 级别 30 开始,可通过调用__android_set_log_writer
更改日志记录函数。如需了解详情,请参阅 NDK 文档。
运行adb logcat
显示的日志要经过四个级别的过滤:
编译时过滤:根据编译设置,某些日志可能会从二进制文件中完全移除。例如,可以将 ProGuard 配置为从 Java 代码中移除对Log.d
的调用。系统属性过滤:liblog
会查询一组系统属性以确定要发送到logd
的最低严重级别。如果日志具有MyApp
标记,系统会检查以下属性,并且日志应包含最低严重级别的第一个字母(V
、D
、I
、W
、E
或S
以停用所有日志):log.tag.MyApp
persist.log.tag.MyApp
log.tag
persist.log.tag
应用过滤:如果未设置任何属性,liblog
会使用__android_log_set_minimum_priority
设置的最低优先级。默认设置为INFO
。显示过滤:adb logcat
支持其他可减少logd
显示的日志数量的过滤条件。有关详情,请参阅下文。
命令行语法
如需通过 adb shell 运行 Logcat,一般用法如下:
[adb] logcat [<option>] … [<filter-spec>] …
可以将logcat
作为 adb 命令运行,也可以直接在模拟器或关联设备的 shell 提示中运行。如需使用 adb 查看日志输出,请转到SDKplatform-tools/
(配置了环境变量的话,可以直接打开命令行窗口即可运行) 目录并执行以下命令:
adb logcat
如需获取logcat
在线帮助,请启动设备,然后执行以下命令:
adb logcat --help
可以建立与设备的 shell 连接并执行以下命令:
$ adb shell
logcat命令行选项
下表介绍了logcat
的命令行选项。
过滤日志输出
日志消息的标记是一个简短的字符串,指示消息所源自的系统组件(例如,“View”表示视图系统)。优先级是以下字符值之一(按照从最低到最高优先级的顺序排列):V
:详细(最低优先级)D
:调试I
:信息W
:警告E
:错误F
:严重错误S
:静默(最高优先级,绝不会输出任何内容)通过运行 Logcat 并观察每条消息的前两列,您可以获取系统中使用的带有优先级的标记列表,格式为<priority>/<tag>
。
以下是使用logcat -v brief output
命令获取的简短 Logcat 输出的示例。它表明消息与优先级“I”和标记“ActivityManager”相关:
I/ActivityManager( 585): Starting activity: Intent { action=android.intent.action...}
如要将日志输出降低到可管理的水平,您可以使用过滤器表达式限制日志输出。通过过滤器表达式,您可以向系统指明您感兴趣的标记/优先级组合,系统会针对指定的标记抑制其他消息。
过滤器表达式采用tag:priority ...
格式,其中tag
指示您感兴趣的标记,priority
指示可针对该标记报告的最低优先级。不低于指定优先级的标记的消息会写入日志。您可以在一个过滤器表达式中提供任意数量的tag:priority
规范。一系列规范使用空格分隔。
以下是一个过滤器表达式的示例,该表达式会抑制除标记为“ActivityManager”、优先级不低于“信息”的日志消息,以及标记为“MyApp”、优先级不低于“调试”的日志消息以外的所有其他日志消息:
adb logcat ActivityManager:I MyApp:D *:S
上述表达式中最后一个元素*:S
将所有标记的优先级设为“静默”,从而确保系统仅显示标记为“ActivityManager”和“MyApp”的日志消息。使用*:S
是确保日志输出受限于您已明确指定的过滤器的绝佳方式,它可以让过滤器充当日志输出的“许可名单”。
以下过滤器表达式显示了优先级不低于“警告”的所有标记的所有日志消息:
adb logcat *:W
如果从开发计算机运行 Logcat(相对于在远程 adb shell 上运行),则也可以通过导出环境变量ANDROID_LOG_TAGS
的值设置默认过滤器表达式:
export ANDROID_LOG_TAGS="ActivityManager:I MyApp:D *:S"
请注意,如果从远程 shell 或使用adb shell logcat
运行 Logcat,系统不会将ANDROID_LOG_TAGS
过滤器导出到模拟器/设备实例。
控制日志输出格式
除标记和优先级外,日志消息还包含许多元数据字段。您可以修改消息的输出格式,以便它们显示特定的元数据字段。为此,您可以使用-v
选项,并指定下列某一受支持的输出格式。
brief
:显示优先级、标记以及发出消息的进程的 PID。long
:显示所有元数据字段,并使用空白行分隔消息。process
:仅显示 PID。raw
:显示不包含其他元数据字段的原始日志消息。tag
:仅显示优先级和标记。thread:
:旧版格式,显示优先级、PID 以及发出消息的线程的 TID。threadtime
(默认值):显示日期、调用时间、优先级、标记、PID 以及发出消息的线程的 TID。time
:显示日期、调用时间、优先级、标记以及发出消息的进程的 PID。
启动 Logcat 时,您可以使用-v
选项指定所需的输出格式:
[adb] logcat [-v <format>]
以下示例显示了如何生成输出格式为thread
的消息:
adb logcat -v thread
请注意,您只能使用-v
选项指定一种输出格式,但可以指定任意数量的有意义的修饰符。Logcat 会忽略没有意义的修饰符。
格式修饰符
格式修饰符依据以下一个或多个修饰符的任意组合更改 Logcat 输出。如要指定格式修饰符,请使用-v
选项,如下所示:
adb logcat -b all -v color -d
每个 Android 日志消息都有一个与之相关联的标记和优先级。可以将任何格式修饰符与以下任一格式选项进行组合:brief
、long
、process
、raw
、tag
、thread
、threadtime
和time
。
可以通过在命令行中输入logcat -v --help
获取格式修饰符详细信息。
color
:使用不同的颜色来显示每个优先级。descriptive
:显示日志缓冲区事件说明。此修饰符仅影响事件日志缓冲区消息,不会对其他非二进制文件缓冲区产生任何影响。事件说明取自 event-log-tags 数据库。epoch
:显示自 1970 年 1 月 1 日以来的时间(以秒为单位)。monotonic
:显示自上次启动以来的时间(以 CPU 秒为单位)。printable
:确保所有二进制日志记录内容都进行了转义。uid
:如果访问控制允许,则显示 UID 或记录的进程的 Android ID。usec
:显示精确到微秒的时间。UTC
:显示 UTC 时间。year
:将年份添加到显示的时间。zone
:将本地时区添加到显示的时间。
查看备用日志缓冲区
Android 日志记录系统为日志消息保留了多个环形缓冲区,而且并非所有的日志消息都会发送到默认的环形缓冲区。如要查看其他日志消息,您可以使用-b
选项运行logcat
命令,以请求查看备用的环形缓冲区。您可以查看下列任意备用缓冲区:
radio
:查看包含无线装置/电话相关消息的缓冲区。events
:查看已经过解译的二进制系统事件缓冲区消息。main
:查看主日志缓冲区(默认),不包含系统和崩溃日志消息。system
:查看系统日志缓冲区(默认)。crash
:查看崩溃日志缓冲区(默认)。all
:查看所有缓冲区。default
:报告main
、system
和crash
缓冲区。
以下是 -b 选项的用法:
[adb] logcat [-b <buffer>]
以下示例显示了如何查看包含无线装置和电话相关消息的日志缓冲区。
adb logcat -b radio
此外,也可以为要输出的所有缓冲区指定多个-b
标记,如下所示:
logcat -b main -b radio -b events
可以指定一个-b
标记,后跟缓冲区逗号分隔列表,例如:
logcat -b main,radio,events
通过代码记录日志
通过Log
类,您可以在代码中创建日志条目,而这些条目会显示在 Logcat 工具中。常用的日志记录方法包括:
Log.v(String, String)
(详细)Log.d(String, String)
(调试)Log.i(String, String)
(信息)Log.w(String, String)
(警告)Log.e(String, String)
(错误)
例如,使用以下调用:
Log.i("MyActivity", "MyClass.getView() — get item number " + position);
Logcat 输出类似如下:
I/MyActivity( 1557): MyClass.getView() — get item number 1
如果觉得《Android日志[进阶篇]三-Logcat 命令行工具》对你有帮助,请点赞、收藏,并留下你的观点哦!