Firebase Crashlytics 使用入门

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

设置 Crashlytics 需要在 Firebase 控制台和 IDE 中分别执行一些操作（例如添加 Firebase 配置文件和 Crashlytics SDK）。为了完成设置，您需要强制造成一次测试崩溃，以便向 Firebase 发送您的第一个崩溃报告。

准备工作

  1. 将 Firebase 添加到您的 Apple 项目（如果尚未添加）。如果您没有 Apple 应用，可以下载一个示例应用。

  2. 建议：要自动获取面包屑导航日志以了解导致崩溃事件、非严重事件或 ANR 事件的用户操作，您需要在 Firebase 项目中启用 Google Analytics。

    • 如果您的现有 Firebase 项目未启用 Google Analytics，您可以访问 Firebase 控制台，依次点击 >“项目设置”，然后在集成标签页中启用 Google Analytics。

    • 如果您要创建新的 Firebase 项目，请在项目创建过程中启用 Google Analytics。

第 1 步：将 Crashlytics SDK 添加到您的应用

使用 Swift Package Manager 安装和管理 Firebase 依赖项。

  1. 在 Xcode 中打开您的应用项目，依次点击 File（文件）> Add Packages（添加软件包）。
  2. 出现提示时，添加 Firebase Apple 平台 SDK 代码库：
    3.   https://github.com/firebase/firebase-ios-sdk.git
  3. 选择 Crashlytics 库。
  4. 如需利用面包屑导航日志，还可以将 Firebase SDK for Google Analytics 添加到您的应用中。确保您的 Firebase 项目中启用了 Google Analytics。
  5. 将 -ObjC 标志添加到目标 build 设置的“其他链接器标志”部分。
  6. （仅限 macOS）在 Info.plist 中，添加键 NSApplicationCrashOnExceptions 并将其设置为 YES。
  7. 完成之后，Xcode 将会自动开始在后台解析和下载您的依赖项。

接下来，配置 Firebase 模块：

  1. 在 App 结构体或 UIApplicationDelegate 中导入 Firebase 模块：

    Swift

    import Firebase

    Objective-C 

    @import Firebase;

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

    Swift

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

    Objective-C

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

第 3 步：强制造成一次测试崩溃以完成设置

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


大功告成！Crashlytics 现在会监控您的应用是否发生崩溃。 您可以访问 Crashlytics 信息中心以查看和调查所有报告和统计信息。

后续步骤

  • 与 Google Play 集成，以便您可以直接在 Crashlytics 信息中心内按 Google Play 轨道过滤 Android 应用的崩溃报告。这样可让 Crashlytics 信息中心更有侧重地显示特定 build 的崩溃信息。