Erste Schritte mit Crashlytics für Android

In dieser Anleitung wird beschrieben, wie Sie Firebase Crashlytics in Ihrer Android-App einrichten.

Nachdem Sie das Firebase Crashlytics SDK in Ihrer App eingerichtet haben, können Sie umfassende Absturzberichte in der Firebase Konsole abrufen. Mit Crashlytics für Android erhalten Sie Berichte zu Abstürzen, nicht schwerwiegenden Fehlern und "Application Not Responding" (ANR) Fehlern.

Für die Einrichtung von Crashlytics sind sowohl Aufgaben in der Firebase Console 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, um Ihren ersten Absturzbericht an Firebase zu senden.

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 die Nutzeraktionen zu verstehen, die zu einem Absturz, einem nicht schwerwiegenden Fehler oder einem ANR-Ereignis geführt haben, müssen Sie Google Analytics in Ihrem Firebase-Projekt aktivieren.

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

   • Wenn Sie ein vorhandenes Firebase-Projekt verwenden, für das Google Analytics nicht aktiviert ist, können Sie es in den settings Einstellungen > Integrationen Seite der Firebase Konsole aktivieren.

3. Ihre App muss die folgenden Mindestversionen haben:

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

Schritt 1: Crashlytics SDK zu Ihrer App hinzufügen

Wenn Sie Navigationspfadlogs nutzen möchten, fügen Sie Ihrer App außerdem das Firebase SDK für Google Analytics hinzu. Google Analytics muss in Ihrem Firebase-Projekt aktiviert sein.

dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:34.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.

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:20.0.6")
    implementation("com.google.firebase:firebase-analytics:23.2.0")
}

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

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

   Kotlin

   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.4" apply false
   
       // Add the dependency for the Crashlytics Gradle plugin
       id("com.google.firebase.crashlytics") version "3.0.7" apply false
   }

   Groovy

   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.4' apply false
   
       // Add the dependency for the Crashlytics Gradle plugin
       id 'com.google.firebase.crashlytics' version '3.0.7' apply false
   }

2. Fügen Sie in der Gradle-Datei des Moduls (auf Anwendungsebene) (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

Um die Einrichtung von Crashlytics abzuschließen und erste Daten im Crashlytics Dashboard der Firebase Console zu sehen, 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 in der MainActivity Ihrer App eine Schaltfläche hinzufügen, die beim Drücken einen Absturz verursacht. Die Schaltfläche ist mit „Testabsturz“ beschriftet.

   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. Drücken Sie in Ihrer App auf die Schaltfläche „Testabsturz“, die Sie mit dem obigen Code hinzugefügt haben.

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

4. Rufen Sie in der Firebase Console das DevOps & Engagement > Crashlytics dashboard auf und suchen Sie nach dem Testabsturz report.

   Wenn Sie die Console aktualisiert haben und den Testabsturz nach fünf Minuten immer noch nicht sehen, aktivieren Sie die Debug-Protokollierung , um zu prüfen, ob Ihre App Absturzberichte sendet.

Geschafft! Crashlytics überwacht jetzt Ihre App auf Abstürze, nicht schwerwiegende Fehler und ANRs. Auf dem Crashlytics Dashboard können Sie alle Berichte und Statistiken ansehen und untersuchen.

Nächste Schritte

• Passen Sie die Einrichtung von Absturzberichten an indem Sie die optionale Berichterstellung, Logs, Schlüssel und die Erfassung nicht schwerwiegender Fehler hinzufügen.

• Integrieren Sie Google Play, 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.

• Daten in Android Studio ansehen und filtern Crashlytics

  • 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.
  • Informationen zur Verwendung des AQI-Fensters finden Sie in der Android Studio-Dokumentation.
  • Treten Sie mit uns in Kontakt! Senden Sie uns Feedback zum AQI-Fenster, indem Sie einen Fehlerbericht einreichen.

• Exportieren Sie Ihre Daten nach BigQuery oder Cloud Logging , um erweiterte Analysen durchzuführen und Funktionen wie das Abfragen von Daten, das Erstellen benutzerdefinierter Dashboards und das Einrichten benutzerdefinierter Benachrichtigungen zu nutzen.