開始使用 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」(新增 Package)。
  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. 在 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 應用程式的當機報告。這樣一來，您就能更專注於特定建構版本。