通过 App Quality Insights 分析 Firebase Crashlytics 和 Android Vitals 的问题

您可以直接在 Android Studio 中查看并处理来自 Firebase Crashlytics 和 Android Vitals 的应用崩溃数据。此集成功能将来自 Crashlytics 和 Google Play 的堆栈跟踪数据和崩溃统计信息提取到 Studio IDE 中的 App Quality Insights 工具窗口中，让您无需在浏览器和 IDE 之间来回切换。开发团队可以受益于多项关键功能，包括：

查看代码中与 Crashlytics 事件数据相关的高亮行。
查看顶级崩溃的堆栈跟踪信息，并点击堆栈跟踪跳转至代码中的相关行。
查看有关顶级崩溃和非致命事件的汇总统计信息，例如按设备制造商和 Android 版本分组的信息。
按严重程度、时间和应用版本等属性过滤事件。
获取一个浏览器链接，打开包含该事件更多详细信息的 Crashlytics 信息中心页面。
获取洞察信息，帮助您更轻松地理解并解决特定问题的根本原因。

Android Vitals 报告适用于所有发布到 Google Play 的应用。如果您尚未使用 Crashlytics 并希望了解更多相关功能，请参阅 Firebase Crashlytics。

开始使用

要在 Android Studio 中查看 Crashlytics 数据，您需要在应用项目中设置 Firebase 和 Crashlytics。具体操作步骤如下：前往 Tools > Firebase 打开 Android Studio 中的 Firebase Assistant，点击 Crashlytics，然后按照教程将 Firebase 和 Crashlytics 添加到您的项目中。您可以阅读Firebase Android 入门指南，详细了解 Firebase Assistant 的工作流程。

如果您已将 Firebase 和 Crashlytics 添加到应用中，请通过点击头像图标登录 IDE 中的开发者账号。登录后，点击 App Quality Insights 工具窗口。您应该会看到面板中填充了来自 Crashlytics 的报告。

分析 Android Vitals

App Quality Insights 包含 Android Vitals 数据。这让您可以更轻松地访问 Google Play 收集的核心指标，并改善用户体验。使用 Android Vitals 解决与应用稳定性相关的问题，有助于提升应用在 Google Play 上的质量。

Android vitals data in Android Studio.

您可以直接在 App Quality Insights 工具窗口中查看 Android Vitals 问题、对其进行过滤，并从堆栈跟踪跳转到代码。要开始使用，请执行以下步骤：

使用工具栏末尾的个人资料图标登录您的 Android Studio 开发者账号。
通过点击 Android Studio 中的工具窗口或点击 View > Tool Windows > App Quality Insights 来打开 App Quality Insights。
点击 App Quality Insights 中的 Android vitals 标签页。
可选：要为可调试构建使用版本控制集成，请将最新的 Firebase Crashlytics SDK（或 Firebase Android 物料清单）添加到您的应用中。然后将以下代码添加到模块级的 build.gradle.kts 或 build.gradle 文件中。正式（不可调试）构建默认已启用此标志。

注意： App Quality Insights 仅支持使用 git 进行版本控制。

Kotlin

android {
  buildTypes {
    getByName("debug") {
      vcsInfo {
        include = true
      }
    }
  }
}

Groovy

android {
  buildTypes {
    debug {
      vcsInfo {
        include true
      }
    }
  }
}

在 Android Studio 中分析 Crashlytics 数据

App Quality Insights 工具窗口提供了丰富的数据，让您能够深入了解用户遇到的事件，并提供链接帮助您快速导航到这些事件的源头。

App Quality Insights tool window

使用应用程序 ID 下拉菜单选择您想要分析的应用 ID。例如，虽然您可能在 IDE 中处理应用的调试版本，但您可能希望查看用户所安装的应用生产版本的事件数据。
Issues（问题）面板显示了 Crashlytics 拥有数据的顶级事件，并按影响力最大的崩溃进行了排序。
按变体（即具有相似堆栈跟踪的事件组）查看事件。按变体分析事件有助于您确定崩溃的根本原因。
Stack trace（堆栈跟踪）标签页显示了您在 Issues 面板中点击的事件的最新发生详情。您可以查看事件的堆栈跟踪信息，并点击堆栈跟踪跳转到代码库中的相关行。如果您的代码在崩溃发生后发生了更改，请点击堆栈跟踪中错误旁边的 show diff，以查看当前代码与生成该崩溃的代码库版本之间的差异。

此外还有关于受影响设备类型、Android 版本以及事件发生时间的信息，以及指向 Firebase Crashlytics 信息中心内该事件的链接。要浏览组中多个事件的信息，请使用左箭头和右箭头。点击 Close issue 可直接从面板中关闭问题。
Keys（键）和 Logs（日志）标签页显示了每个 Crashlytics 报告的自定义键值对和日志。
Details（详细信息）面板按设备类型和 Android 版本细分了崩溃次数，因此您可以确定受影响最严重的用户群。它还显示了哪些应用版本遇到了该崩溃以及受影响的用户数量。
阅读并为问题添加备注，以便 Firebase 控制台和您的团队成员能够看到这些备注。要撰写关于某个问题的备注，请选择该问题并打开 Notes 面板。您必须拥有 Crashlytics 项目的写入权限才能撰写备注。带有备注的问题会在 Issues 面板中显示一个“备注”图标。
使用各种过滤器来锁定特定事件子集。您可以选择或取消选择致命事件、非致命事件和 ANR ，还可以按时间、应用版本、Crashlytics 信号、设备品牌和型号以及 Android 平台版本进行过滤。请注意，对于 Crashlytics 信号状态，如果一个问题过去曾被关闭过，但在应用的新版本中再次出现，则被视为回归。

除了能够从堆栈跟踪导航到代码外，您还可以从代码跳转到堆栈跟踪：Android Studio 现在会在与崩溃相关的代码行旁边用崩溃装订线图标进行标注，以便您轻松发现并进行调试。

当您将鼠标悬停在崩溃图标上时，会弹出一个窗口，显示涉及该行代码的事件数量以及事件频率。

点击崩溃图标可查看更详细的事件列表，包括给定事件的频率和受影响的用户数量。点击特定事件可跳转到 App Quality Insights 工具窗口中的事件详情。

Android Vitals 与 Crashlytics 之间的数据差异

请注意，Android Vitals 和 Crashlytics 针对同一崩溃报告的用户数和事件数可能会有所不同。出现这些差异是因为 Play 和 Crashlytics 可能在不同时间点及针对不同用户捕获崩溃。以下是 Play 和 Crashlytics 统计数据可能存在差异的几个原因：

Play 从开机时间开始捕获崩溃，而 Crashlytics 则捕获在 Crashlytics SDK 初始化之后发生的崩溃。
如果用户在购买新手机时选择不发送崩溃报告，这些崩溃就不会报告给 Play；而 Crashlytics 则是根据应用自身的隐私政策来捕获崩溃的。

在离线状态下进行有限功能调查

如果您发起新请求（例如点击 Refresh），但 Android Studio 无法与 Crashlytics 通信，App Quality Insights 窗口将允许您进入 Offline Mode（离线模式）。

App Quality Insights offers offline mode.

在此模式下，您可以继续调查问题并查看缓存数据中的最新事件。某些功能（例如更改某些过滤选项或关闭问题）将无法使用。要重试连接到 Crashlytics 并恢复到在线状态，请点击 Reconnect 。

权限

请参阅服务权限。