Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

Erste Schritte mit Firebase Crashlytics

In dieser Schnellstartanleitung wird beschrieben, wie Sie Firebase Crashlytics in Ihrer App mit dem Firebase Crashlytics SDK einrichten, damit Sie umfassende Absturzberichte in der Firebase-Konsole erhalten.

Das Einrichten von Crashlytics erfordert Aufgaben sowohl in der Firebase-Konsole als auch in Ihrer IDE (wie das Hinzufügen einer Firebase-Konfigurationsdatei und des Crashlytics SDK). Um die Einrichtung abzuschließen, müssen Sie einen Testabsturz erzwingen, um Ihren ersten Absturzbericht an Firebase zu senden.

Bevor Sie beginnen

  1. Wenn Sie nicht bereits haben, fügen Sie Firebase zu Ihrem iOS - Projekt. Wenn Sie nicht über einen iOS - App haben, können Sie eine Download - Beispielanwendung .

  2. Empfohlen: Um Funktionen wie absturzfrei Benutzer zu erhalten, Paniermehl Protokolle und Geschwindigkeit Warnungen, müssen Sie Google Analytics in Ihrem Projekt Firebase ermöglichen.

    • Wenn Ihre vorhandene Firebase Projekt nicht Google Analytics aktiviert haben, können Sie Google Analytics aus der aktivieren Register Integrationen Ihrer > Projekteinstellungen in der Konsole Firebase.

    • Wenn Sie ein neues Firebase-Projekt erstellen, aktivieren Sie Google Analytics während des Projekterstellungsworkflows.

Schritt 1: Aktivieren Crashlytics in der Konsole Firebase

  1. Gehen Sie auf die Crashlytics Armaturenbrett in der Konsole Firebase.

  2. Stellen Sie sicher , dass Ihre App aus dem Drop - Down - Auswahl neben Crashlytics am oberen Rand der Seite.

  3. Klicken Sie auf Aktivieren Crashlytics.

Schritt 2: Fügen Sie die Firebase Crashlytics SDK in Ihrer App

  1. Öffnen Sie die podfile Sie für Ihre Firebase Projekt erstellt und das Hinzufügen FirebaseCrashlytics pod.

    Für ein optimales Benutzererlebnis Crashlytics, empfehlen wir Google Analytics ermöglicht in Ihrem Firebase - Projekt und das Hinzufügen der Firebase pod für Google Analytics in Ihrer App.

    pod 'Firebase/Crashlytics'
    
    # Recommended: Add the Firebase pod for Google Analytics
    pod 'Firebase/Analytics'
    
  2. Installieren Sie die Schoten, dann wieder öffnen Ihre .xcworkspace Datei , um das Projekt in Xcode zu sehen:

    pod install
    open your-project.xcworkspace
    
  3. Importieren Sie die Firebase Modul in Ihrem UIApplicationDelegate :

    Schnell

    import Firebase

    Ziel c

    @import Firebase;
  4. Konfigurieren ein FirebaseApp gemeinsame Instanz, in der Regel in Ihrem App - application:didFinishLaunchingWithOptions: Methode:

    Schnell

    // Use the Firebase library to configure APIs.
    FirebaseApp.configure()
    

    Ziel c

    // Use the Firebase library to configure APIs.
    [FIRApp configure];
    

Schritt 3: Richten Sie Xcode automatisch laden DSYM Dateien

Um für Menschen lesbare Absturzberichte zu erstellen, benötigt Crashlytics die Debug-Symboldateien (dSYM) Ihres Projekts. In den folgenden Schritten wird beschrieben, wie Sie Xcode so konfigurieren, dass Ihre dSYMs automatisch erstellt, verarbeitet und die Dateien beim Erstellen Ihrer App hochgeladen werden.

  1. Öffnen Sie den Xcode-Arbeitsbereich Ihres Projekts und wählen Sie dann die Projektdatei im linken Navigator aus.

  2. Von der Ziele - Liste, wählen Sie Ihr Haupt Build - Ziel.

  3. Klicken Sie auf die Build - Registerkarte Einstellungen, dann die folgenden Schritte aus , so dass Xcode dSYMs für Ihre baut produziert.

    1. Klicken Sie auf Alle, dann suchen Sie nach debug information format - debug information format .

    2. Set Debug Information Format zu ZWERG mit DSYM Datei für alle Build - Typen.

  4. Klicken Sie auf die Build - Phasen Registerkarte dann die folgenden Schritte aus , so dass Xcode Ihre dSYMs verarbeiten kann und die Dateien hochladen.

    1. Klicken Sie auf > New Run Script Phase.

      Stellen Sie sicher , dass diese neue Run Script Phase Ihres Projekts letzten Build - Phase; Andernfalls kann Crashlytics dSYMs nicht richtig verarbeiten.

    2. Erweitern Sie den neuen Run Script Abschnitt.

    3. Im Skript Feld (unter dem Shell - Etikett befindet), fügen Sie das folgende Skript ausführen.

      Dieses Skript verarbeitet die dSYM-Dateien Ihres Projekts und lädt die Dateien in Crashlytics hoch.

      "${PODS_ROOT}/FirebaseCrashlytics/run"
    4. Im Eingabedateien Abschnitt, fügen Sie die Pfade für die folgenden Dateien.

      • Fügen Sie den Pfad zu den dSYM-Dateien Ihres Projekts hinzu

        Dadurch kann Crashlytics dSYMs für große Apps schneller verarbeiten.

        ${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}/Contents/Resources/DWARF/${TARGET_NAME}
      • Fügen Sie den Pfad zu Ihrem Projekt integrierten Info.plist - Datei

        Dadurch kann Crashlytics den dSYMs eine App-Version zuordnen.

        $(SRCROOT)/$(BUILT_PRODUCTS_DIR)/$(INFOPLIST_PATH)

Für detailliertere Informationen über DSYM Dateien und Crashlytics (einschließlich , wie Sie manuell DSYM Dateien hochladen), Besuch Get Absturzberichte deobfuscated .

Schritt 4: Kraft ein Test Crash Setup zu beenden

Um die Einrichtung von Crashlytics abzuschließen und die ersten Daten im Crashlytics-Dashboard der Firebase-Konsole anzuzeigen, müssen Sie einen Testabsturz erzwingen.

  1. Fügen Sie Ihrer App Code hinzu, mit dem Sie einen Testabsturz erzwingen können.

    Mit dem folgenden Code können Sie Ihrer App eine Schaltfläche hinzufügen, die beim Drücken einen Absturz verursacht. Der Button ist mit "Test Crash" beschriftet.

    Schnell

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

    Ziel 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. Erstellen und führen Sie Ihre App in Xcode aus. Verwenden Sie die folgenden Schritte, um sicherzustellen, dass Ihr Testgerät oder Simulator vom Xcode-Debugger getrennt ist (der Crashlytics stört).

    1. Klicken Sie Erstellen und dann das aktuelle Schema führen Sie Ihre Anwendung auf einem Testgerät oder Simulator zu bauen.

    2. Warten Sie, bis Ihre Anwendung ausgeführt wird , klicken Sie dann auf Stopp der Regelung oder eine Aktion ausgeführt wird die anfängliche Instanz Ihrer App zu schließen. Diese erste Instanz enthielt den Debugger, der Crashlytics stört.

  3. Erzwingen Sie den Testabsturz, um den ersten Absturzbericht Ihrer App zu senden:

    1. Öffnen Sie Ihre App vom Startbildschirm Ihres Testgeräts oder Simulators.

    2. Klicken Sie in Ihrer App auf die Schaltfläche "Absturz testen", die Sie mit dem obigen Code hinzugefügt haben.

    3. Nachdem Ihre App abgestürzt ist, führen Sie sie in Xcode erneut aus, damit Ihre App den Absturzbericht an Firebase senden kann.

  4. Gehen Sie auf die Crashlytics Armaturenbrett der Firebase Konsole Ihren Test Absturz zu sehen.

    Wenn Sie die Konsole aktualisiert haben und Sie immer noch nicht den Test Crash nach fünf Minuten zu sehen, aktivieren Sie die Debug - Protokollierung zu sehen , ob Ihre App Berichte Absturz zu senden.


Und das ist es! Crashlytics überwacht jetzt Ihre App auf Abstürze und Sie können Absturzberichte und -statistiken im Crashlytics-Dashboard anzeigen und untersuchen.

Nächste Schritte

  • Passen Sie Ihre Crash - Bericht Setup durch Hinzufügen von Opt-in - Reporting, Protokolle, Schlüssel und Verfolgung von nicht-tödlichen Fehler.