測試 Crashlytics 實作 (Apple 平台)

選取平台： iOS+ Android Flutter Unity


如果您已按照入門指南操作，但 Crashlytics 資訊主頁仍未顯示當機資料，請參閱本指南。

強制當機，測試導入成果

  1. 在應用程式中加入程式碼，強制造成測試當機。

    您可以使用下列程式碼，在應用程式中加入按鈕，按下後就會造成當機。按鈕標籤為「Test Crash」。

    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]
  }
}

    Objective-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. 按一下 「Build and then run the current scheme」，在測試裝置或模擬器上建構應用程式。

    2. 等到應用程式執行後，按一下 「Stop running the scheme or action」，關閉應用程式的初始執行個體。這個初始執行個體包含會干擾 Crashlytics 的偵錯工具。

  3. 強制執行測試當機，以便傳送應用程式的第一份當機報告：

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

    2. 在應用程式中，按下使用上述程式碼新增的「Test Crash」按鈕。

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

  4. 在 Firebase 控制台中，依序前往「DevOps & Engagement」(開發運作與參與度) >「Crashlytics dashboard」(資訊主頁)，查看測試當機報告。

    如果重新整理控制台後，五分鐘內仍未看到測試當機事件，請嘗試啟用偵錯記錄檔 (下一節)。

啟用 Crashlytics 的偵錯記錄檔功能

如果 Crashlytics 資訊主頁未顯示測試當機事件，您可以使用 Crashlytics 的偵錯記錄檔功能，追蹤問題。

  1. 啟用偵錯記錄功能：

    1. 在 Xcode 中，依序選取「Product」>「Scheme」>「Edit scheme」。

    2. 在左選單中選取「Run」，然後選取「Arguments」分頁標籤。

    3. 在「Arguments Passed on Launch」部分中，加入 -FIRDebugEnabled。

  2. 強制測試當機。本頁第一節將說明如何執行這項操作。

  3. 在記錄中，搜尋 Crashlytics 傳送的記錄訊息，其中包含下列字串，用於驗證應用程式是否將當機資料傳送至 Firebase。

    Completed report submission

如果五分鐘後，您仍未在 Firebase 控制台的「DevOps & Engagement」 > 「Crashlytics」資訊主頁中看到這項記錄或測試當機事件，請與 Firebase 支援團隊聯絡，並附上記錄輸出內容副本，以便我們進一步協助您排解問題。

後續步驟