Перейти к консоли

Firebase Crashlytics 使用入门

本快速入门将向您介绍如何设置 Firebase Crashlytics,以便您能够在 Firebase 控制台中获取完整详尽的崩溃报告。

准备工作

您必须先注册 Android 应用并将其配置为使用 Firebase,然后才能设置 Crashlytics。

  • 如果您的 Android 应用已在使用 Firebase,则表示您已注册该 Android 应用并已将其配置为使用 Firebase。

  • 如果您没有任何 Android 应用,可以下载一个示例应用

    请注意,将 Firebase 添加到 Android 应用需要在 Firebase 控制台中和打开的 Android 项目中执行若干任务(例如,从控制台下载 Firebase 配置文件,然后将这些配置文件移动到 Android 项目中)。

第 1 步:在 Firebase 控制台中设置 Crashlytics

  1. Firebase 控制台的左侧导航面板中点击 Crashlytics

  2. 如果您的 Firebase 项目中注册了多个应用,请从控制台顶栏中的 Crashlytics 旁边的下拉列表中选择刚刚添加的应用。

  3. 点击设置 Crashlytics

  4. 选择此应用是第一次安装 Crashlytics(它没有安装过此 SDK 的任何版本)

第 2 步:添加 Crashlytics SDK

  1. 在项目级 build.gradle 中,将您的 google-services 更新为 3.1.2 或更高版本,然后添加 Crashlytics 代码库和依赖项:

    buildscript {
        repositories {
            // Add the following repositories:
            google()  // Google's Maven repository
    
            maven {
               url 'https://maven.fabric.io/public'
            }
        }
    
        dependencies {
            // ...
    
            // Check for v3.1.2 or higher
            classpath 'com.google.gms:google-services:4.3.2'  // Google Services plugin
    
            // Add dependency
            classpath 'io.fabric.tools:gradle:1.31.0'  // Crashlytics plugin
    
            
        }
    }
    
    allprojects { // ... repositories { // Check that you have the following line (if not, add it): google() // Google's Maven repository // ... } }

  2. 在应用级 build.gradle 中,将 firebase-core 更新为 v11.4.2 或更高版本,然后添加 Crashlytics 依赖项:

    apply plugin: 'com.android.application'
    apply plugin: 'io.fabric'
    
    dependencies { // ... // Check for v11.4.2 or higher implementation 'com.google.firebase:firebase-core:17.2.0' // (Recommended) Add Analytics implementation 'com.google.firebase:firebase-analytics:17.2.0' // Add dependency implementation 'com.crashlytics.sdk.android:crashlytics:2.10.1' }

  3. (对于使用 NDK 的应用是可选项)如果您的应用使用的是 Android 原生库,您可以将 Crashlytics 配置为报告您的 NDK 库中的崩溃问题。如需查看相关说明,请参阅获取 Android NDK 崩溃报告

    将 SDK 添加到您的应用后,Crashlytics 会自动开始侦听并收集崩溃报告。

第 3 步:初始化 Crashlytics

在您将 Crashlytics 添加到您的应用后,Firebase Crashlytics SDK 会立即自动初始化 Crashlytics。

第 4 步:构建或运行您的项目

运行您的应用,向 Firebase 发送您已成功集成 Firebase 的验证信息。

您的设备日志将显示说明初始化已完成的 Firebase 验证信息。如果您是在具有网络访问权限的模拟器上运行应用,则 Firebase 控制台会向您发送通知,告知应用连接已完成。

观看视频教程

如需详细的 Crashlytics 上手指南,请观看以下视频教程:

您可以通过 Firebase 的 YouTube 频道找到更多视频。

后续步骤

  • 测试您的实现 - 强制造成一次崩溃以在 Firebase 控制台中生成崩溃报告,从而测试您的 Crashlytics 设置。

  • 自定义崩溃报告 - 在您添加 SDK 后,Crashlytics 就会立即自动开始收集崩溃报告,但您也可以通过添加自选式报告、日志、键甚至跟踪非严重错误来自定义您的设置。