Firebase Crashlytics 使用入门

此快速入门介绍了如何使用 Firebase Crashlytics SDK 在应用中设置 Firebase Crashlytics，以便您可以在 Firebase 控制台中获得全面的崩溃报告。

准备工作

将 Firebase 添加到您的 iOS 项目（如果尚未添加）。如果您没有任何 iOS 应用，可以下载一个示例应用。
建议做法：若要使用“未遇到崩溃问题的用户”、“面包屑导航日志”和“疾速崩溃提醒”等功能，您需要在 Firebase 项目中启用 Google Analytics（分析）。
- 如果您的现有 Firebase 项目未启用 Google Analytics（分析），您可以访问 Firebase 控制台，依次点击“”>“项目设置”，然后在集成标签页中启用 Google Analytics（分析）。
- 如果您要创建新的 Firebase 项目，请在项目创建工作流内启用 Google Analytics（分析）。

注意：我们建议使用 CocoaPods 安装 Firebase 库。如果您是使用 Swift Package Manager 设置的 Firebase，则可以跳过与 CocoaPods 相关的步骤，例如修改 Podfile 和运行 pod 命令。

打开为 Firebase 项目创建的 podfile，然后添加 FirebaseCrashlytics Pod。

为了获得最佳的 Crashlytics 使用体验，我们建议您在 Firebase 项目中启用 Google Analytics（分析），并将适用于 Google Analytics（分析）的 Firebase pod 添加到您的应用中。
```
pod 'Firebase/Crashlytics'

# Recommended: Add the Firebase pod for Google Analytics
pod 'Firebase/Analytics'
```
安装 pod，然后重新打开 .xcworkspace 文件以便在 Xcode 中查看该项目：
```
pod install
open your-project.xcworkspace
```
在 UIApplicationDelegate 中导入 Firebase 模块：
Swift
```
import Firebase
```
Objective-C
```
@import Firebase;
```

配置一个 FirebaseApp 共享实例（通常在应用的 application:didFinishLaunchingWithOptions: 方法中配置）：

  // Use the Firebase library to configure APIs.
  FirebaseApp.configure()

  // Use the Firebase library to configure APIs.
  [FIRApp configure];

您可以通过将运行脚本添加到项目的构建阶段来初始化 Crashlytics。运行代码可以让 Xcode 在您的应用崩溃时自动上传项目的 dSYM 文件，以便 Crashlytics 自动生成崩溃报告。

在 Xcode 中打开您的项目，然后在左侧导航栏中选择其项目文件。
从 Select a project or target 下拉列表中选择您的主要构建目标。
选择 Build Phases 标签页，然后依次点击 > New Run Script Phase。
展开随即显示的新 Run Script 部分。在脚本字段（位于 Shell 字段下）中，添加一个新的运行脚本：
```
"${PODS_ROOT}/FirebaseCrashlytics/run"
```
将应用的 dSYM 位置添加为输入文件，这能让 Crashlytics 更快地为大型应用自动生成 dSYM。例如：
```
${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}/Contents/Resources/DWARF/${TARGET_NAME}
```
您还可以在构建阶段的 Input Files 字段中提供应用已构建的 Info.plist 的位置：
```
$(SRCROOT)/$(BUILT_PRODUCTS_DIR)/$(INFOPLIST_PATH)
```

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

运行您的应用。您的设备日志应显示表明初始化已完成的 Firebase 验证信息。

若要完成 Crashlytics 设置并在 Firebase 控制台的 Crashlytics 信息中心内查看初始数据，您需要强制造成一次测试崩溃。

若要详细了解如何执行此操作，请参阅测试您的实现。