Android日志[进阶篇]四-获取错误报告

Android日志[进阶篇]一-使用 Logcat 写入和查看日志
Android日志[进阶篇]二-分析堆栈轨迹(调试和外部堆栈)
Android日志[进阶篇]三-Logcat命令行工具
Android日志[进阶篇]四-获取错误报告
Android日志[进阶篇]五-阅读错误报告

前言

大多数人都习惯断点调试，断点复现，但往往效率低下且面对上线后出现的问题无从下手，本文介绍错误日志的获取，logcat之外的日志，也就是线上运行日志或用户设备的日志。

错误报告包含设备日志、堆栈轨迹和其他诊断信息，可以帮助我们查找和修复应用中的错误。通过以下几种方式可以从设备上获取错误报告：使用设备上的生成错误报告开发人员选项、Android 模拟器菜单或开发机器上的 adb bugreport 命令。

在这里插入图片描述

图 1. 开发人员选项

如需生成错误报告，必须在设备上启用开发者选项，以便访问生成错误报告（提交错误报告）选项。

从设备上获取错误报告

在这里插入图片描述

图 2. 错误报告已准备就绪

如需直接从设备上获取错误报告，请执行以下操作：

确保设备已启用开发人员选项。
在开发者选项中，点按提交错误报告。
选择所需的错误报告类型（完整或互动式），然后点按报告。
接着收集并提取相关的错误报告，可以从状态栏中看到这个过程，也可以重新命名报告的最终文件名，稍后，便会收到错误报告已准备就绪的通知（参见图 2）。
如需分享错误报告，请点按该通知。系统会根据可分享的渠道进行分享，如蓝牙等方式传输到电脑

从 Android 模拟器上获取错误报告

在 Android 模拟器中，使用“Extended controls”窗口中的 File a bug 功能：

点击模拟器面板中的 More 图标。
在 Extended controls 窗口中，选择左侧的 Bug report。

此时系统会打开一个屏幕，可以在其中查看错误报告详细信息，例如屏幕截图、AVD 配置信息和错误报告日志。还可以输入一条包含重现步骤的消息，以便与报告一起保存。
等待错误报告完成收集，然后点击 Save Report。

使用 adb 获取错误报告

如果只连接了一台设备，则可以使用 adb 获取错误报告，如下所示：

$ adb bugreport E:\Reports\MyBugReports

如果没有指定错误报告的路径，系统会将其保存到本地目录。

如果连接了多台设备，则必须使用 -s 选项指定设备。运行以下 adb 命令可获取设备序列号并生成错误报告。

$ adb devices

List of devices attached

emulator-5554      device
8XV7N15C31003476 device

$ adb -s 8XV7N15C31003476 bugreport

检查错误报告 ZIP 文件

默认情况下，ZIP 文件称为 bugreport-BUILD_ID-DATE.zip （bugreport-ANE-AL00-HUAWEIANE-AL00-2021-09-10-17-00-09.zip），它可能会包含多个文件，但最重要的文件是 bugreport-BUILD_ID-DATE.txt (bugreport-ANE-AL00-HUAWEIANE-AL00-2021-09-10-17-00-09.txt)。此文件就是错误报告，它包含系统服务 (dumpsys)、错误日志 (dumpstate) 和系统消息日志 (logcat) 的诊断输出。系统消息包括设备抛出错误时的堆栈轨迹，以及从所有应用中使用 Log 类写入的消息。

ZIP 文件中有一个 version.txt 元数据文件，其中包含 Android 版本号，而且启用 systrace 后，ZIP 文件中还会包含 systrace.txt 文件。Systrace 工具可以获取并显示应用进程和其他 Android 系统进程的执行时间，从而帮助分析应用的性能。

dumpstate 工具会将文件从设备的文件系统复制到 ZIP 文件的 FS 文件夹下，以便引用它们。例如，设备中的 /dirA/dirB/fileC 文件会在 ZIP 文件中生成 FS/dirA/dirB/fileC 条目。

在这里插入图片描述
图 3. 错误报告文件结构