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

Firebase Crashlytics 使用入门

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

准备工作

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

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

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

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

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

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

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

  3. 点击设置 Crashlytics

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

第 2 步:添加 Crashlytics SDK

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

第 3 步:初始化 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 位置添加到 Build Phase 的 Input Files 字段中:

    $(SRCROOT)/$(BUILT_PRODUCTS_DIR)/$(INFOPLIST_PATH)

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

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

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

您的设备日志将显示说明初始化已完成的 Firebase 验证信息。

观看视频教程

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

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

后续步骤

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

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