開始使用 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」 專案建立流程

    請注意,除了 watchOS 以外,Crashlytics 支援的所有 Apple 平台都支援麵包屑記錄。

步驟 1:在應用程式中加入 Crashlytics SDK

使用 Swift Package Manager 安裝及管理 Firebase 依附元件。

  1. 在 Xcode 中保持開啟應用程式專案,然後前往「檔案」檔案 >新增套件
  2. 在系統提示時,新增 Firebase Apple 平台 SDK 存放區:
  3.   https://github.com/firebase/firebase-ios-sdk.git
    敬上
  4. 選擇 Crashlytics 程式庫。
  5. 充分運用 導覽標記記錄 也請將 Google Analytics 的 Firebase SDK 加進您的應用程式。請確認 已啟用 Google Analytics
  6. 在目標建構設定的「Other Linker Flags」部分中新增 -ObjC 標記。
  7. (僅限 macOS)Info.plist 中新增 NSApplicationCrashOnExceptions 鍵,並將其設為 YES
  8. 完成後,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];

步驟 2:設定 Xcode 以自動上傳 dSYM 檔案

如要產生人類可讀的當機報告,Crashlytics 需要專案的 偵錯符號 (dSYM) 檔案。下列步驟說明如何設定 Xcode,以便在您建構應用程式時自動產生 dSYM、處理 dSYM,並上傳這些檔案。

  1. 開啟專案的 Xcode 工作區,然後在 使用這個按鈕

  2. 從「TARGETS」(目標) 清單中選取主要建構目標。

  3. 按一下「Build Settings」分頁標籤,然後完成下列步驟, Xcode 會為建構產生 dSYM。

    1. 按一下「全部」,然後搜尋「debug information format」。

    2. 將您所有的「偵錯資訊格式」設為 DWARF with dSYM File 建構類型

  4. 按一下「Build Phases」分頁標籤,然後完成下列步驟, Xcode 可以處理您的 dSYM 並上傳檔案。

    1. 按一下 > 新執行指令碼階段

      確認這個新的「Run Script」階段是專案的最後版本 階段;否則,Crashlytics 無法正確處理 dSYM。

    2. 展開新的「執行指令碼」部分。

    3. 在指令碼欄位 (位於「Shell」標籤下方) 中,新增下列執行指令碼。

      這個指令碼會處理專案的 dSYM 檔案,並將檔案上傳至 Crashlytics

      "${BUILD_DIR%/Build/*}/SourcePackages/checkouts/firebase-ios-sdk/Crashlytics/run"
    4. 在「Input Files」(輸入檔案) 區段中,新增 下列檔案:

      ${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}
      ${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}/Contents/Resources/DWARF/${PRODUCT_NAME}
      ${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}/Contents/Info.plist
      $(TARGET_BUILD_DIR)/$(UNLOCALIZED_RESOURCES_FOLDER_PATH)/GoogleService-Info.plist
      $(TARGET_BUILD_DIR)/$(EXECUTABLE_PATH)

如要進一步瞭解 dSYM 檔案和 Crashlytics (包括如何手動上傳 dSYM 檔案),請參閱「取得經過去除模糊處理的當機報告」。

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

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

  1. 在應用程式中新增程式碼,以便強制執行測試當機。

    您可以使用下列程式碼,在應用程式中加入按鈕,當按下該按鈕時會導致應用程式當機。該按鈕標示為「測試當機」。

    SwiftUI

    Button("Crash") {
      fatalError("Crash was triggered")
    }

    UIKit

    Swift

    import UIKit
    
    class ViewController: UIViewController {
      override func viewDidLoad() {
          super.viewDidLoad()
    
          // Do any additional setup after loading the view, typically from a nib.
    
          let button = UIButton(type: .roundedRect)
          button.frame = CGRect(x: 20, y: 50, width: 100, height: 30)
          button.setTitle("Test Crash", for: [])
          button.addTarget(self, action: #selector(self.crashButtonTapped(_:)), for: .touchUpInside)
          view.addSubview(button)
      }
    
      @IBAction func crashButtonTapped(_ sender: AnyObject) {
          let numbers = [0]
          let _ = numbers[1]
      }
    }

    目標-C

    #import "ViewController.h"
    
    @implementation ViewController(void)viewDidLoad {
        [super viewDidLoad];
    
        // Do any additional setup after loading the view, typically from a nib.
    
        UIButton* button = [UIButton buttonWithType:UIButtonTypeRoundedRect];
        button.frame = CGRectMake(20, 50, 100, 30);
        [button setTitle:@"Test Crash" forState:UIControlStateNormal];
        [button addTarget:self action:@selector(crashButtonTapped:)
            forControlEvents:UIControlEventTouchUpInside];
        [self.view addSubview:button];
    }
    
     (IBAction)crashButtonTapped:(id)sender {
        @[][1];
    }
    
    @end
  2. 在 Xcode 中建構並執行應用程式,並且斷開 Xcode 偵錯工具的連線。

    1. 按一下 「建立」,然後點選 執行目前的配置,在測試裝置上建構應用程式,或 模擬工具

    2. 請等待應用程式執行,然後按一下 「停止執行配置或動作」,關閉應用程式的初始例項。這個初始例項包含會干擾 Crashlytics 的偵錯工具。

  3. 強制執行測試當機,以便傳送應用程式的首份當機報告:

    1. 從測試裝置或模擬器的主畫面開啟應用程式。

    2. 在應用程式中,按下「測試當機」透過程式碼新增的按鈕 。

    3. 應用程式當機後,請透過 Xcode 再次執行應用程式,以便應用程式將當機報告傳送至 Firebase。

  4. 前往 Firebase 控制台的 Crashlytics 資訊主頁,查看測試異常終止情形。

    如果您已重新整理控制台,但五分鐘後仍未看到測試異常終止,請啟用偵錯記錄,看看應用程式是否會傳送異常終止報告。


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

後續步驟