本快速入門導覽課程說明如何在應用程式中使用 Firebase Crashlytics SDK 設定 Firebase Crashlytics,以便在 Firebase 控制台中取得完整的當機報告。
如要設定 Crashlytics,您必須具備 Firebase 控制台和 IDE 中的工作 (例如新增 Firebase 設定檔和 Crashlytics SDK)。您需要強制測試當機,才能將第一份當機報告傳送至 Firebase,才能完成設定。
事前準備
如果您尚未在 Apple 專案中新增 Firebase,請先完成這項操作。如果您沒有 Apple 應用程式,可以下載範例應用程式。
建議做法:如要自動取得導覽標記記錄,瞭解引發當機、一般錯誤或 ANR 事件的使用者動作,您必須在 Firebase 專案中啟用 Google Analytics (分析)。
如果現有的 Firebase 專案尚未啟用 Google Analytics (分析),您可以在 Firebase 控制台中前往
,在 >「專案設定」「整合」分頁中啟用 Google Analytics (分析)。 如要建立新的 Firebase 專案,請在專案建立工作流程中啟用 Google Analytics (分析)。
步驟 1:在應用程式中加入 Crashlytics SDK
使用 Swift Package Manager 安裝及管理 Firebase 依附元件。
- 在 Xcode 中保持開啟應用程式專案,然後依序點選「File」>「Add Packages」。
- 在系統提示時,新增 Firebase Apple 平台 SDK 存放區:
- 選擇 Crashlytics 程式庫。
- 如要利用導覽標記記錄,請一併將 Google Analytics (分析) 專用 Firebase SDK 新增至您的應用程式。請務必在 Firebase 專案中啟用 Google Analytics (分析)。
- 在目標建構設定的「Other Linker Flags」部分中新增
-ObjC
標記。 - (僅限 macOS) 在
Info.plist
中,新增NSApplicationCrashOnExceptions
鍵並設為YES
。 - 完成後,Xcode 會自動開始在背景解析並下載依附元件。
https://github.com/firebase/firebase-ios-sdk.git
接下來,設定 Firebase 模組:
將 Firebase 模組匯入
App
結構或UIApplicationDelegate
:Swift
import Firebase
目標-C
@import Firebase;
設定
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 應用程式的當機報告。如此一來,您就能將資訊主頁的重點放在特定版本上。