Probleme in Firebase Crashlytics und Android Vitals mit App Quality Insights analysieren

Sie können App-Absturzdaten aus Firebase Crashlytics und Android Vitals direkt in Android Studio aufrufen und darauf reagieren. Bei dieser Integration werden Stack-Trace-Daten und Absturzstatistiken aus Crashlytics und Google Play in das Toolfenster App Quality Insights in der Studio IDE gezogen, sodass Sie nicht zwischen Ihrem Browser und der IDE wechseln müssen. Entwicklungsteams profitieren von wichtigen Funktionen, darunter:

  • Zeilen in Ihrem Code werden hervorgehoben, wenn sie zugehörige Crashlytics-Ereignisdaten enthalten.
  • Sehen Sie sich den Stacktrace für die häufigsten Abstürze an und klicken Sie darauf, um zu den relevanten Zeilen in Ihrem Code zu springen.
  • Hier finden Sie Zusammenfassungsstatistiken zu den häufigsten Abstürzen und nicht schwerwiegenden Ereignissen, z. B. nach Gerätehersteller und Android-Version gruppiert.
  • Ereignisse nach Attributen wie Schweregrad, Uhrzeit und App-Version filtern
  • Sie erhalten einen Browserlink, über den die Crashlytics-Dashboardseite mit weiteren Details zum Ereignis geöffnet wird.
  • Sie erhalten Statistiken, mit denen Sie die Ursachen bestimmter Probleme leichter nachvollziehen und beheben können.

Android Vitals-Berichte sind für alle bei Google Play veröffentlichten Apps verfügbar. Wenn Sie Crashlytics noch nicht verwenden und mehr über die angebotenen Funktionen erfahren möchten, lesen Sie den Hilfeartikel Firebase Crashlytics.

Erste Schritte

Wenn Sie Crashlytics-Daten in Android Studio sehen möchten, müssen Sie Firebase und Crashlytics in Ihrem App-Projekt einrichten. So gehts: Öffnen Sie den Firebase Assistant in Android Studio. Klicken Sie dazu auf Tools > Firebase, dann auf Crashlytics und folgen Sie der Anleitung, um Firebase und Crashlytics zu Ihrem Projekt hinzuzufügen. Weitere Informationen zum Firebase Assistant-Workflow finden Sie im Firebase-Startleitfaden für Android.

Wenn Sie Ihrer App bereits Firebase und Crashlytics hinzugefügt haben, melden Sie sich in der IDE in Ihrem Entwicklerkonto an, indem Sie auf das Avatarsymbol  klicken. Klicken Sie nach der Anmeldung auf das Toolfenster App Quality Insights (Statistiken zur App-Qualität) . Die Bereiche sollten jetzt Berichte aus Crashlytics enthalten.

Android Vitals analysieren

Statistiken zur App-Qualität enthalten Daten zu Android Vitals. So können Sie einfacher auf die wichtigsten von Google Play erfassten Messwerte zugreifen und die Nutzerfreundlichkeit verbessern. Mit Android Vitals können Sie Probleme im Zusammenhang mit der App-Stabilität beheben und so die Qualität Ihrer App bei Google Play verbessern.

Android Vitals-Daten in Android Studio

Im Toolfenster App-Qualitätsstatistiken können Sie Android Vitals-Probleme ansehen, filtern und vom Stacktrace zum Code springen. Führen Sie zuerst die folgenden Schritte aus:

  1. Melden Sie sich in Android Studio über das Profilsymbol  am Ende der Symbolleiste in Ihrem Entwicklerkonto an.
  2. Öffnen Sie App Quality Insights, indem Sie in Android Studio auf das Toolfenster klicken oder auf Ansicht > Toolfenster > App Quality Insights.
  3. Klicken Sie unter Statistiken zur App-Qualität auf den Tab Android Vitals.
  4. Optional: Wenn Sie die Versionskontrollintegration für einen debuggbaren Build verwenden möchten, fügen Sie Ihrer App das neueste Firebase Crashlytics SDK (oder die Firebase Android-Bill of Materials) hinzu. Fügen Sie dann der build.gradle.kts- oder build.gradle-Datei auf Modulebene den folgenden Code hinzu. Bei Release-Builds (nicht debuggbar) ist das Flag standardmäßig aktiviert.

Kotlin

android {
  buildTypes {
    getByName("debug") {
      vcsInfo {
        include = true
      }
    }
  }
}

Groovy

android {
  buildTypes {
    debug {
      vcsInfo {
        include true
      }
    }
  }
}

Das Toolfenster App-Qualitätsstatistiken enthält umfangreiche Daten, die Aufschluss über die Ereignisse geben, die Ihre Nutzer sehen. Außerdem finden Sie dort Links, über die Sie schnell zu den Quellen dieser Ereignisse gelangen.

Fenster des App Quality Insights-Tools

  1. Wählen Sie im Drop-down-Menü „Anwendungs-ID“ die App-ID aus, die Sie analysieren möchten. Wenn Sie beispielsweise in der IDE an der Debug-Version Ihrer App arbeiten, möchten Sie möglicherweise Ereignisdaten für die Produktionsversion Ihrer App sehen, die Ihre Nutzer installieren.
  2. Im Bereich Probleme werden die wichtigsten Ereignisse angezeigt, für die Crashlytics Daten hat. Die Ereignisse sind nach den schwerwiegendsten Abstürzen sortiert.
  3. Sie können sich Ereignisse nach Varianten oder nach Gruppen von Ereignissen mit ähnlichen Stacktraces ansehen. Wenn Sie Ereignisse nach Variante analysieren, können Sie die Grundursachen eines Absturzes ermitteln.
  4. Auf dem Tab Stack-Trace finden Sie Details zum letzten Auftreten des Ereignisses, auf das Sie im Bereich Probleme geklickt haben. Sie können den Stacktrace des Ereignisses aufrufen und darauf klicken, um zu den relevanten Zeilen in Ihrer Codebasis zu springen. Wenn sich Ihr Code seit dem Absturz geändert hat, klicken Sie neben dem Fehler im Stack-Trace auf Diff anzeigen, um einen Vergleich zwischen Ihrem aktuellen Code und der Version Ihrer Codebasis aufzurufen, die den Absturz verursacht hat.

    Option zum Anzeigen von Unterschieden im LQI-Stack-Trace.

    Außerdem finden Sie Informationen zum betroffenen Gerätetyp, zur Android-Version und zum Zeitpunkt des Ereignisses sowie einen Link zum Ereignis im Firebase Crashlytics-Dashboard. Mit den Pfeiltasten nach links und rechts können Sie sich Informationen zu mehreren Ereignissen in einer Gruppe ansehen. Klicken Sie auf Problem schließen, um ein Problem direkt im Steuerfeld zu schließen.

  5. Auf den Tabs Schlüssel und Protokolle werden benutzerdefinierte Schlüssel/Wert-Paare und Protokolle für jeden Crashlytics-Bericht angezeigt.
  6. Im Bereich Details werden die Absturzzahlen nach Gerätetyp und Android-Version aufgeschlüsselt, damit Sie ermitteln können, welche Nutzergruppen am stärksten betroffen sind. Außerdem sehen Sie, bei welchen App-Versionen der Absturz aufgetreten ist, und die Anzahl der betroffenen Nutzer.
  7. Lesen Sie sich die Probleme durch und hängen Sie Notizen an, damit sie in der Firebase Console und für Ihre Teammitglieder sichtbar sind. Wenn Sie eine Notiz zu einem Problem erstellen möchten, wählen Sie das Problem aus und öffnen Sie den Bereich Notizen. Sie benötigen Schreibberechtigungen für das Crashlytics-Projekt, um Notizen hinzufügen zu können. Probleme mit Notizen werden im Bereich Probleme mit dem Symbol „Notizen“  gekennzeichnet.
    Bereich „App Quality Insights“
  8. Mit den verschiedenen Filtern können Sie sich bestimmte Teilmengen von Ereignissen ansehen. Sie können Ereignisse vom Typ „Fatal“ (), „Non-Fatal“ () und ANRs () auswählen oder die Auswahl aufheben und nach Zeit, App-Version, Crashlytics-Signal, Gerätehersteller und ‑modell sowie Android-Plattformversion filtern. Bei den Crashlytics-Signalstatus gilt ein Problem als regressiv, wenn es in der Vergangenheit geschlossen wurde und in einer neuen Version der App wieder aufgetreten ist.

Sie können nicht nur vom Stack-Trace zum Code wechseln, sondern auch vom Code zum Stack-Trace. In Android Studio werden Codezeilen, die mit Abstürzen zusammenhängen, jetzt mit einem Crash-Gutter-Symbol  gekennzeichnet, damit Sie sie leicht erkennen und beheben können.

Wenn Sie den Mauszeiger auf das Symbol für den Absturz bewegen, wird ein Pop-up mit Informationen dazu angezeigt, wie viele Ereignisse sich auf diese Codezeile beziehen und wie oft sie auftreten.

Ereigniszusammenfassung, wenn der Mauszeiger auf das Symbol für Abstürze bewegt wird

Klicken Sie auf das Symbol für Abstürze, um eine detailliertere Liste der Ereignisse aufzurufen, einschließlich der Häufigkeit und Anzahl der Nutzer, die von einem bestimmten Ereignis betroffen sind. Klicken Sie auf ein bestimmtes Ereignis, um die Ereignisdetails im Toolfenster App Quality Insights aufzurufen.

Ereignisliste, wenn Sie auf das Absturzsymbol klicken

Unterschiedliche Zahlen in Android Vitals und Crashlytics

Beachten Sie, dass in Android Vitals und Crashlytics möglicherweise unterschiedliche Werte für die Anzahl der Nutzer und Ereignisse angegeben werden, die mit demselben Absturz in Verbindung stehen. Diese Abweichungen treten auf, weil Google Play und Crashlytics Abstürze zu unterschiedlichen Zeiten und bei unterschiedlichen Nutzern erfassen können. Hier sind einige Gründe, warum sich die Anzahl der Abstürze in Google Play und Crashlytics unterscheiden kann:

  • Google Play erfasst Abstürze ab dem Start, während Crashlytics Abstürze erfasst, die nach der Initialisierung des Crashlytics SDK auftreten.
  • Wenn ein Nutzer die Absturzberichte deaktiviert, wenn er ein neues Smartphone erhält, werden diese Abstürze nicht an Google Play gesendet. Crashlytics erfasst jedoch Abstürze basierend auf der eigenen Datenschutzerklärung einer App.

Probleme mit eingeschränkter Funktionalität im Offlinemodus untersuchen

Wenn Sie eine neue Anfrage stellen, z. B. indem Sie auf Aktualisieren klicken, und Android Studio nicht mit Crashlytics kommunizieren kann, können Sie im Fenster App Quality Insights den Offlinemodus aktivieren.

App Quality Insights bietet einen Offlinemodus.

In diesem Modus können Sie weiterhin Probleme und die neuesten Ereignisse anhand der im Cache gespeicherten Daten untersuchen. Bestimmte Funktionen, z. B. das Ändern einiger Filteroptionen oder das Schließen von Problemen, sind nicht verfügbar. Wenn Sie die Verbindung zu Crashlytics noch einmal versuchen und zum Onlinestatus zurückkehren möchten, klicken Sie auf Verbinden .