捕获和读取错误报告

错误报告包含设备日志、堆栈轨迹以及其他诊断信息，可帮助您查找和修复应用中的错误。要从设备捕获错误报告，请使用设备上的 Take bug report 开发者选项、Android 模拟器菜单或开发机器上的 adb bugreport 命令。

图 1. 设备上的开发者选项。

要获取错误报告，您必须在设备上启用开发者选项才能访问 Take bug report 选项。

从设备捕获错误报告

图 2. 错误报告已就绪。

要直接从设备获取错误报告，请执行以下操作

  1. 启用开发者选项。
  2. 在开发者选项中，点按Take bug report。
  3. 选择您想要的错误报告类型，然后点按报告。

    稍等片刻，您会收到错误报告已就绪的通知，如图 2 所示。

  4. 要分享错误报告，请点按该通知。

从 Android 模拟器捕获错误报告

在 Android 模拟器中，您可以使用扩展控件中的 File a bug 功能

  1. 点击 更多 在模拟器面板中。

  2. 在扩展控件窗口中，选择错误报告。

    这将打开一个屏幕，您可以在其中查看错误报告详细信息，例如屏幕截图、AVD 配置信息和错误报告日志。您还可以输入包含重现步骤的消息，并将其与报告一起保存。

  3. 等待错误报告收集完毕，然后点击保存报告。

使用 adb 捕获错误报告

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

$ adb bugreport E:\Reports\MyBugReports

如果您不指定错误报告的路径，它将保存到本地目录。

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

$ adb devices
List of devices attached
emulator-5554      device
8XV7N15C31003476 device

$ adb -s 8XV7N15C31003476 bugreport

保存较旧的错误报告

默认情况下，错误报告保存到 /bugreports，可以使用以下命令查看：

$ adb shell ls /bugreports/
bugreport-foo-bar.xxx.YYYY-MM-DD-HH-MM-SS-dumpstate_log-yyy.txt
bugreport-foo-bar.xxx.YYYY-MM-DD-HH-MM-SS.zip
dumpstate-stats.txt

然后，您可以通过 adb pull 拉取 zip 文件。

$ adb pull /bugreports/bugreport-foo-bar.xxx.YYYY-MM-DD-HH-MM-SS.zip

检查错误报告 zip 文件

默认情况下，zip 文件名为 bugreport-BUILD_ID-DATE.zip。该 zip 文件可以包含多个文件，但最重要的文件是 bugreport-BUILD_ID-DATE.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. 错误报告文件结构。

如需了解更多信息，请参阅阅读错误报告。

从用户获取报告

当您自己使用应用时，捕获错误报告很有帮助，但您的最终用户无法轻松与您分享此类错误报告。要从实际用户那里获取包含堆栈轨迹的崩溃报告，请利用 Google Play 和 Firebase 崩溃报告功能。

Google Play 管理中心

您可以从 Google Play 管理中心获取报告，以查看从 Google Play 安装您应用的用户所产生的崩溃和应用无响应 (ANR) 错误数据。数据可追溯至前六个月。

如需了解更多信息，请参阅 Play 管理中心帮助中的查看崩溃和应用无响应 (ANR) 错误。

Firebase 崩溃报告

Firebase Crashlytics 报告会创建您应用中错误的详细报告。错误会根据相似的堆栈轨迹分组为问题，并根据对用户影响的严重程度进行分类。除了自动报告外，您还可以记录自定义事件，以帮助捕获导致崩溃的步骤。

要开始接收来自任何用户的崩溃报告，请将Firebase 依赖项添加到您的 build.gradle 文件中。如需了解更多信息，请参阅Firebase Crashlytics。