Erste Schritte mit Firebase Crashlytics

iOS+ Android Flutter Unity

In dieser Kurzanleitung wird beschrieben, wie Sie Firebase Crashlytics in Ihrer App mit dem Firebase Crashlytics SDK einrichten, damit Sie umfassende Absturzberichte in der Firebase-Konsole erhalten. Mit Crashlytics für Android erhalten Sie Berichte zu Abstürzen, nicht schwerwiegenden Fehlern und ANR-Fehlern („App antwortet nicht“).

Für die Einrichtung von Crashlytics sind Aufgaben sowohl in der Firebase-Konsole als auch in Ihrer IDE erforderlich, z. B. das Hinzufügen einer Firebase-Konfigurationsdatei und des Crashlytics SDK. Um die Einrichtung abzuschließen, müssen Sie einen Testabsturz erzwingen, damit Ihr erster Absturzbericht an Firebase gesendet wird.

Hinweis

1. Fügen Sie Ihrem Android-Projekt Firebase hinzu, falls noch nicht geschehen. Wenn Sie keine Android-App haben, können Sie eine Beispiel-App herunterladen.

2. Empfohlen: Wenn Sie automatisch Navigationspfadlogs erhalten möchten, um Nutzeraktionen zu verstehen, die zu einem Absturz, einem nicht schwerwiegenden Ereignis oder einem ANR-Ereignis geführt haben, müssen Sie Google Analytics in Ihrem Firebase-Projekt aktivieren.

   • Wenn Google Analytics in Ihrem vorhandenen Firebase-Projekt nicht aktiviert ist, können Sie Google Analytics auf dem Tab Integrationen unter  > Projekteinstellungen in der Firebase Console aktivieren.

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

3. Ihre App muss die folgenden Mindestversionen haben:

   • Gradle 8.0
   • Android Gradle-Plug-in 8.1.0
   • Google-Dienste-Gradle-Plug-in 4.4.1

Schritt 1: Crashlytics SDK in Ihre App einfügen

Verwendet Ihre App das NDK? In der Dokumentation zur NDK-Absturzerfassung erfahren Sie, wie Sie Crashlytics so konfigurieren, dass Abstürze in den zugrunde liegenden NDK-Bibliotheken Ihrer App erfasst werden.

Fügen Sie in Ihrer Gradle-Moduldatei (auf App-Ebene) (normalerweise <project>/<app-module>/build.gradle.kts oder <project>/<app-module>/build.gradle) die Abhängigkeit für die Crashlytics-Bibliothek für Android hinzu. Wir empfehlen, Firebase Android BoM zu verwenden, um die Versionierung der Bibliothek zu steuern.

Wenn Sie Breadcrumb-Logs verwenden möchten, fügen Sie Ihrer App außerdem das Firebase SDK für Google Analytics hinzu. Achten Sie darauf, dass Google Analytics in Ihrem Firebase-Projekt aktiviert ist.

dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:33.13.0"))

    // Add the dependencies for the Crashlytics and Analytics libraries
    // When using the BoM, you don't specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-crashlytics")
    implementation("com.google.firebase:firebase-analytics")
}

Mit der Firebase Android BoM haben Sie immer eine kompatible Version der Firebase Android-Bibliotheken in Ihrer App.

Alternative: Firebase-Bibliotheksabhängigkeiten ohne BoM hinzufügen

Wenn Sie die Firebase BoM nicht verwenden, müssen Sie jede Firebase-Bibliotheksversion in der entsprechenden Abhängigkeitszeile angeben.

Wenn Sie mehrere Firebase-Bibliotheken in Ihrer App verwenden, empfehlen wir Ihnen dringend, die Bibliotheksversionen mithilfe der BoM zu verwalten. So wird sichergestellt, dass alle Versionen kompatibel sind.

dependencies {
    // Add the dependencies for the Crashlytics and Analytics libraries
    // When NOT using the BoM, you must specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-crashlytics:19.4.3")
    implementation("com.google.firebase:firebase-analytics:22.4.0")
}

Sie suchen nach einem Kotlin-spezifischen Bibliotheksmodul? Ab Oktober 2023 (Firebase BoM 32.5.0) können sowohl Kotlin- als auch Java-Entwickler das Hauptbibliotheksmodul verwenden. Weitere Informationen finden Sie in den häufig gestellten Fragen zu dieser Initiative.

Schritt 2: Crashlytics-Gradle-Plug-in zur App hinzufügen

1. Fügen Sie in der Gradle-Datei auf Stammebene (Projektebene) (<project>/build.gradle.kts oder <project>/build.gradle) dem Block plugins das Gradle-Plug-in Crashlytics hinzu:

   Kotlin

   Verwenden Sie immer noch die Syntax buildscript? Weitere Informationen zum Hinzufügen von Firebase-Plug-ins mit dieser Syntax

   plugins {
       // Make sure that you have the AGP plugin 8.1+ dependency
       id("com.android.application") version "8.1.4" apply false
       // ...
   
       // Make sure that you have the Google services Gradle plugin 4.4.1+ dependency
       id("com.google.gms.google-services") version "4.4.2" apply false
   
       // Add the dependency for the Crashlytics Gradle plugin
       id("com.google.firebase.crashlytics") version "3.0.3" apply false
   }

   Groovy

   Verwenden Sie immer noch die Syntax buildscript? Weitere Informationen zum Hinzufügen von Firebase-Plug-ins mit dieser Syntax

   plugins {
       // Make sure that you have the AGP plugin 8.1+ dependency
       id 'com.android.application' version '8.1.4' apply false
       // ...
   
       // Make sure that you have the Google services Gradle plugin 4.4.1+ dependency
       id 'com.google.gms.google-services' version '4.4.2' apply false
   
       // Add the dependency for the Crashlytics Gradle plugin
       id 'com.google.firebase.crashlytics' version '3.0.3' apply false
   }

   Verwendet Ihre App eine niedrigere Gradle-Version? Sie sollten ein Upgrade durchführen. Andernfalls sollten Sie Version 2.9.9 des Crashlytics Gradle-Plug-ins verwenden.

2. Fügen Sie in der Gradle-Datei des Moduls (auf App-Ebene) (in der Regel <project>/<app-module>/build.gradle.kts oder <project>/<app-module>/build.gradle) das Crashlytics-Gradle-Plug-in hinzu:

   Kotlin

   plugins {
     id("com.android.application")
     // ...
   
     // Make sure that you have the Google services Gradle plugin
     id("com.google.gms.google-services")
   
     // Add the Crashlytics Gradle plugin
     id("com.google.firebase.crashlytics")
   }

   Groovy

   plugins {
     id 'com.android.application'
     // ...
   
     // Make sure that you have the Google services Gradle plugin
     id 'com.google.gms.google-services'
   
     // Add the Crashlytics Gradle plugin
     id 'com.google.firebase.crashlytics'
   }

Schritt 3: Testabsturz erzwingen, um die Einrichtung abzuschließen

Wenn Sie die Einrichtung von Crashlytics abschließen und erste Daten im Crashlytics-Dashboard der Firebase-Konsole sehen möchten, 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 in der MainActivity-Datei Ihrer App können Sie eine Schaltfläche hinzufügen, die beim Drücken einen Absturz verursacht. Die Schaltfläche trägt die Bezeichnung „Test Crash“.

   Kotlin

   val crashButton = Button(this)
   crashButton.text = "Test Crash"
   crashButton.setOnClickListener {
      throw RuntimeException("Test Crash") // Force a crash
   }
   
   addContentView(crashButton, ViewGroup.LayoutParams(
          ViewGroup.LayoutParams.MATCH_PARENT,
          ViewGroup.LayoutParams.WRAP_CONTENT))

   Java

   Button crashButton = new Button(this);
   crashButton.setText("Test Crash");
   crashButton.setOnClickListener(new View.OnClickListener() {
      public void onClick(View view) {
          throw new RuntimeException("Test Crash"); // Force a crash
      }
   });
   
   addContentView(crashButton, new ViewGroup.LayoutParams(
          ViewGroup.LayoutParams.MATCH_PARENT,
          ViewGroup.LayoutParams.WRAP_CONTENT));

2. Erstellen Sie Ihre App und führen Sie sie aus.

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

   1. Öffnen Sie Ihre App auf Ihrem Testgerät oder Emulator.

   2. Klicken Sie in Ihrer App auf die Schaltfläche „Test Crash“, die Sie mit dem Code oben hinzugefügt haben.

   3. Starten Sie die App nach dem Absturz neu, damit sie den Absturzbericht an Firebase senden kann.

4. Rufen Sie das Crashlytics-Dashboard der Firebase-Konsole auf, um den Testabsturz zu sehen.

   Wenn Sie die Konsole aktualisiert haben und der Test nach fünf Minuten immer noch nicht abgestürzt ist, aktivieren Sie die Debug-Protokollierung, um zu sehen, ob Ihre App Absturzberichte sendet.

Geschafft! Crashlytics überwacht jetzt Ihre App auf Abstürze, nicht schwerwiegende Fehler und ANRs. Im Crashlytics-Dashboard kannst du alle deine Berichte und Statistiken aufrufen und analysieren.

Nächste Schritte

• Passen Sie die Einrichtung von Absturzberichten an, indem Sie optionale Berichte, Protokolle, Schlüssel und das Tracking nicht schwerwiegender Fehler hinzufügen.

• Google Play einbinden, damit Sie die Absturzberichte Ihrer Android-App direkt im Crashlytics-Dashboard nach Google Play-Track filtern können So können Sie Ihr Dashboard besser auf bestimmte Builds ausrichten.

• In Android Studio können Sie Crashlytics-Daten aufrufen und filtern.
  • Im Fenster App Quality Insights (AQI) in Android Studio können Sie Crashlytics-Daten neben Ihrem Code ansehen. Sie müssen also nicht zwischen dem Crashlytics-Dashboard und der IDE hin- und herwechseln, um die wichtigsten Probleme zu beheben.
  • Weitere Informationen zur Verwendung des LQI-Fensters finden Sie in der Android Studio-Dokumentation.
  • Treten Sie mit uns in Kontakt! Wenn Sie uns Feedback zum Fenster für den LQI geben möchten, senden Sie uns einen Fehlerbericht.