開始使用 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 控制台，在 >「專案設定」中，透過「Integrations」分頁啟用 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. 將 -ObjC 旗標新增至目標建構設定中的「Other Linker Flags」區段。
  6. (僅限 macOS) 在 Info.plist 中新增 NSApplicationCrashOnExceptions 鍵，並將其設為 YES。
  7. 完成後，Xcode 就會自動開始在背景中解析並下載依附元件。

接著，設定 Firebase 模組：

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

    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 應用程式的當機報告。如此一來，資訊主頁就能更專注於特定建構。