Erste Schritte mit Firebase Crashlytics

Diese Kurz beschreibt , wie Firebase Crashlytics in Ihrer App mit dem Firebase Crashlytics SDK einzurichten, so dass Sie umfassende Crash - Berichte im bekommen Firebase Konsole .

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: Führen Sie das Projekt

Führen Sie Ihre App aus. In Ihren Geräteprotokollen sollte die Firebase-Überprüfung angezeigt werden, dass die Initialisierung abgeschlossen ist.

Schritt 5: 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.

Einzelheiten dazu , wie dies zu tun, besuchen Testen Sie Ihre Implementierung .

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.