Firebase Crashlytics 使用入门

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

准备工作

将 Firebase 添加到您的 iOS 项目(如果尚未添加)。如果您没有任何 iOS 应用,可以下载一个示例应用

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

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

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

  3. 点击启用 Crashlytics

第 2 步:将 Firebase Crashlytics 添加到您的应用

  1. 打开为 Firebase 项目创建的 podfile,然后添加 FirebaseCrashlytics Pod。为了获得最佳的 Firebase Crashlytics 使用体验,我们建议您将适用于 Analytics(分析)的 Firebase Pod 添加到您的应用,从而在您的项目中启用 Google Analytics(分析)。请务必添加 Google Analytics(分析)6.3.1 版或更高版本,以便获得实时的“未受崩溃事件影响的用户数”和面包屑导航。

    pod 'Firebase/Crashlytics'
    
    # Recommended: Add the Firebase pod for Google Analytics
    pod 'Firebase/Analytics'
    
  2. 安装 pod,然后重新打开 .xcworkspace 文件以便在 Xcode 中查看该项目:

    pod install
    open your-project.xcworkspace
    
  3. UIApplicationDelegate 中导入 Firebase 模块:

    Swift

    import Firebase

    Objective-C

    @import Firebase;
  4. 配置一个 FirebaseApp 共享实例(通常在应用的 application:didFinishLaunchingWithOptions: 方法中配置):

    Swift

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

    Objective-C

      // Use the Firebase library to configure APIs.
      [FIRApp configure];
      
  5. 重新编译您的应用。

第 3 步:初始化 Crashlytics

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

  1. 在 Xcode 中打开您的项目,然后在左侧导航栏中选择其项目文件。

  2. Select a project or target 下拉列表中选择您的主要构建目标。

  3. 选择 Build Phases 标签页,然后依次点击 > New Run Script Phase

  4. 展开随即显示的新 Run Script 部分。在脚本字段(位于 Shell 字段下)中,添加一个新的运行脚本:

    "${PODS_ROOT}/FirebaseCrashlytics/run"
  5. 将应用的 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 会自动开始侦听并收集崩溃报告。

第 4 步:运行项目

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

后续步骤