Firebase Crashlytics 使用入门

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

iOS
Android

开始之前

iOS

要开始设置,您需要有一个启用了 Firebase Crashlytics 的 Firebase 应用:

Android

要开始设置,您需要有一个启用了 Firebase Crashlytics 的 Firebase 应用:

将 Crashlytics SDK 添加到您的项目

iOS

将 Crashlytics 框架添加到您的 Xcode 工作区

首先,请将 Crashlytics SDK 框架文件添加到您的项目。对于大多数项目来说,最简单的方法是添加 Crashlytics CocoaPods,但是如果您的项目不支持 CocoaPods,您也可以手动添加这些文件。

添加 Crashlytics 运行脚本

您已添加的框架中还包括一个用来初始化 Crashlytics 的运行脚本。请将其添加到您的项目的编译阶段中:

  1. 在 Xcode 中打开您的项目,然后在 Navigator 中选择其项目文件。
  2. Select a project or target 下拉菜单中选择您的主要编译目标。
  3. 打开该目标的 Build Phases 标签。
  4. 点击 + Add a new build phase,然后选择 New Run Script Phase
  5. 将下面这行代码添加到 Type a script... 文本框中:
    CocoaPods 安装
    "${PODS_ROOT}/Fabric/run"
    手动安装
    "${PROJECT_DIR}/Fabric.framework/run"
  6. 仅限 Xcode 10:将应用的已编译 Info.plist 位置添加到构建阶段的 Input Files 字段中:
    $(BUILT_PRODUCTS_DIR)/$(INFOPLIST_PATH)

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

注意:请确保您的新构建阶段是此项目的最后一个构建阶段,否则 Crashlytics 将无法正确初始化。
Android

将 SDK 添加到编译文件中

  1. 在项目级 build.gradle 中,将 google-services 版本更新为 3.1.2 或更高版本,并添加 Crashlytics 代码库和依赖项:
    buildscript {
        repositories {
            // ...
    
            // Add repository
            maven {
               url 'https://maven.fabric.io/public'
            }
        }
        dependencies {
            // ...
    
            // Check for v3.1.2 or higher
            classpath 'com.google.gms:google-services:4.1.0'
    
            // Add dependency
            classpath 'io.fabric.tools:gradle:1.25.4'
        }
    }
    
    allprojects { // ... repositories { // ... // Add repository maven { url 'https://maven.google.com/' } } }
  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:16.0.4' // Add dependency implementation 'com.crashlytics.sdk.android:crashlytics:2.9.5' }

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

后续步骤

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

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

发送以下问题的反馈:

此网页
需要帮助?请访问我们的支持页面