開始使用 Firebase Crashlytics

本快速入門導覽課程說明如何在應用程式中使用 Firebase Crashlytics SDK 設定 Firebase Crashlytics，以便在 Firebase 控制台中取得完整的當機報告。

如要設定 Crashlytics，您必須具備 Firebase 控制台和 IDE 中的工作 (例如新增 Firebase 設定檔和 Crashlytics SDK)。您需要強制測試當機，才能將第一份當機報告傳送至 Firebase，才能完成設定。

事前準備

  1. 如果您尚未在 Apple 專案中新增 Firebase，請先完成這項操作。如果您沒有 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. 如要利用導覽標記記錄，請一併將 Google Analytics (分析) 專用 Firebase SDK 新增至您的應用程式。請務必在 Firebase 專案中啟用 Google Analytics (分析)。
  5. 在目標建構設定的「Other Linker Flags」部分中新增 -ObjC 標記。
  6. (僅限 macOS) 在 Info.plist 中，新增 NSApplicationCrashOnExceptions 鍵並設為 YES。
  7. 完成後，Xcode 會自動開始在背景解析並下載依附元件。

接下來，設定 Firebase 模組：

  1. 將 Firebase 模組匯入 App 結構或 UIApplicationDelegate：

    Swift 

    import Firebase

    目標-C

    @import Firebase;

  2. 設定 FirebaseApp 共用例項，通常位於應用程式委派的 application(_:didFinishLaunchingWithOptions:) 方法中：

    Swift 

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

    目標-C

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

步驟 3：強制測試當機以完成設定

您需要強制執行測試當機，才能完成 Crashlytics 設定，並在 Firebase 控制台的 Crashlytics 資訊主頁中查看初始資料。


大功告成！Crashlytics 正在監控應用程式的當機情形。前往 Crashlytics 資訊主頁，即可查看和調查所有報表和統計資料。

後續步驟

  • 與 Google Play 整合，直接在 Crashlytics 資訊主頁中，依 Google Play 測試群組篩選 Android 應用程式的當機報告。如此一來，您就能將資訊主頁的重點放在特定版本上。