使用 Google Analytics（分析）获取崩溃报告的指标

Google Analytics（分析）是 Firebase 的分析引擎。如果将 Analytics（分析）与 Crashlytics 结合使用，您可以获得帮助制造问题以及更细致地跟踪崩溃数据的各种功能，例如未遇到崩溃问题的用户数、在崩溃出现之前跟踪特定事件的路径，还可以借助 BigQuery 直观呈现应用的关键指标。

本指南介绍如何将 Google Analytics（分析）添加到设置了 Crashlytics 的应用。如果您尚未将 Crashlytics 添加到您的应用，请先添加。

第 1 步：添加 Firebase 配置文件

  1. 将 Firebase Android 配置文件添加到您的应用：

    1. 打开您的项目设置。在您的应用卡片中，选择需要配置文件的应用的软件包名称。

    2. 点击下载 google-services.json，获取 Firebase Android 配置文件 (google-services.json)。

    3. 将配置文件移到应用的模块（应用级）目录中。

  2. 如需在 Android 应用中启用 Firebase 产品，请将 google-services 插件添加到 Gradle 文件中。

    1. 在根级（项目级）Gradle 文件 (build.gradle) 中添加规则，以纳入 Google 服务 Gradle 插件。此外，请确认您拥有 Google 的 Maven 代码库。

      buildscript {

  repositories {
    // Check that you have the following line (if not, add it):
    google()  // Google's Maven repository
  }

  dependencies {
    // ...

    // Add the following line:
    classpath 'com.google.gms:google-services:4.3.13'  // Google Services plugin
  }
}

allprojects {
  // ...

  repositories {
    // Check that you have the following line (if not, add it):
    google()  // Google's Maven repository
    // ...
  }
}

    2. 在您的模块（应用级）Gradle 文件（通常是 app/build.gradle）中，应用 Google 服务 Gradle 插件。

      apply plugin: 'com.android.application'
// Add the following line:
apply plugin: 'com.google.gms.google-services'  // Google Services plugin

android {
  // ...
}

第 2 步：将 Analytics SDK 添加到您的应用

  1. 使用 Firebase Android BoM 在模块（应用级）Gradle 文件（通常为 app/build.gradle）中声明 Analytics Android 库的依赖项。

    Java 

    dependencies {
    // Import the BoM for the Firebase platform
    implementation platform('com.google.firebase:firebase-bom:30.3.1')

    // Declare the dependency for the Analytics library
    // When using the BoM, you don't specify versions in Firebase library dependencies
    implementation 'com.google.firebase:firebase-analytics'
}

    借助 Firebase Android BoM，可确保您的应用使用的始终是 Firebase Android 库的兼容版本。

    （替代方法） 在不使用 BoM 的情况下声明 Firebase 库依赖项

    如果您选择不使用 Firebase BoM，则必须在每个 Firebase 库的依赖项行中指定相应的库版本。

    请注意，如果您在应用中使用多个 Firebase 库，我们强烈建议您使用 BoM 来管理库版本，从而确保所有版本都兼容。

    dependencies {
    // Declare the dependency for the Analytics library
    // When NOT using the BoM, you must specify versions in Firebase library dependencies
    implementation 'com.google.firebase:firebase-analytics:21.1.0'
}

    Kotlin+KTX 

    dependencies {
    // Import the BoM for the Firebase platform
    implementation platform('com.google.firebase:firebase-bom:30.3.1')

    // Declare the dependency for the Analytics library
    // When using the BoM, you don't specify versions in Firebase library dependencies
    implementation 'com.google.firebase:firebase-analytics-ktx'
}

    使用 Firebase Android BoM 可确保您的应用始终使用 Firebase Android 库的兼容版本。

    （替代方法） 在不使用 BoM 的情况下声明 Firebase 库依赖项

    如果您选择不使用 Firebase BoM，则必须在每个 Firebase 库的依赖项行中指定相应的库版本。

    请注意，如果您在应用中使用多个 Firebase 库，我们强烈建议您使用 BoM 来管理库版本，从而确保所有版本都兼容。

    dependencies {
    // Declare the dependency for the Analytics library
    // When NOT using the BoM, you must specify versions in Firebase library dependencies
    implementation 'com.google.firebase:firebase-analytics-ktx:21.1.0'
}

  2. 在您的 Activity 的顶部声明 com.google.firebase.analytics.FirebaseAnalytics 对象：

    Java 

    private FirebaseAnalytics mFirebaseAnalytics;
    MainActivity.java

    Kotlin+KTX 

    private lateinit var firebaseAnalytics: FirebaseAnalytics
    MainActivity.kt

  3. 在 onCreate() 方法中初始化该对象：

    Java 

    // Obtain the FirebaseAnalytics instance.
mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);
    MainActivity.java

    Kotlin+KTX 

    // Obtain the FirebaseAnalytics instance.
firebaseAnalytics = Firebase.analytics
    MainActivity.kt

后续步骤