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 entsprechende Maßnahmen ergreifen. Durch diese Integration werden Stacktrace-Daten und Absturzstatistiken aus Crashlytics und Google Play in das Toolfenster App Quality Insights in der Studio-IDE abgerufen, sodass Sie nicht zwischen unserem Browser und der IDE wechseln müssen. Entwicklungsteams können unter anderem von folgenden wichtigen Funktionen profitieren:

  • Die Zeilen im Code sind hervorgehoben, wenn sie zugehörige Crashlytics-Ereignisdaten enthalten.
  • Sehen Sie sich den Stacktrace nach den häufigsten Abstürzen an und klicken Sie auf den Stacktrace, um zu den relevanten Zeilen im Code zu springen.
  • Sie können sich zusammenfassende Statistiken zu den häufigsten Abstürzen und nicht schwerwiegenden Ereignissen ansehen, z. B. gruppiert nach Gerätehersteller und Android-Version.
  • Ereignisse nach Attributen wie Schweregrad, Zeit und App-Version filtern
  • Rufen Sie einen Browserlink ab, über den die Crashlytics-Dashboard-Seite mit weiteren Details zum Ereignis geöffnet wird.
  • Sie erhalten Statistiken, mit denen Sie die Ursachen bestimmter Probleme leichter verstehen 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 Angebote erfahren möchten, lesen Sie 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. Öffnen Sie dazu in Android Studio den Firebase Assistant. Rufen Sie dazu Tools > Firebase auf, klicken Sie auf Crashlytics und folgen Sie der Anleitung, um Ihrem Projekt Firebase und Crashlytics 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. Klicken Sie dazu auf das Avatarsymbol . Klicken Sie nach der Anmeldung auf das Fenster App Quality Insights. Die Bereiche Probleme, Beispiel-Stacktrace und Details sollten mit Berichten aus Crashlytics angezeigt werden.

Android Vitals analysieren

App Quality Insights umfasst Daten zu Android Vitals. So können Sie leichter auf die von Google Play erfassten Kernmesswerte zugreifen und die Nutzererfahrung verbessern. Mit Android Vitals kannst du Probleme mit der App-Stabilität beheben und die Qualität deiner App bei Google Play verbessern.

Android Vitals-Daten in Android Studio.

Im Toolfenster App Quality Insights kannst du Android Vitals-Probleme aufrufen, filtern und vom Stacktrace zu Code wechseln. Gehen Sie dazu so vor:

  1. Melde dich in Android Studio über das Profilsymbol am Ende der Symbolleiste in deinem Entwicklerkonto an.
  2. Öffnen Sie App Quality Insights, indem Sie in Android Studio auf das Toolfenster oder auf Ansicht > Toolfenster > App Quality Insights klicken.
  3. Klicken Sie in App Quality Insights auf den Tab Android Vitals.
  4. Optional: Wenn Sie die Versionsverwaltung für einen debug-fähigen Build verwenden möchten, fügen Sie Ihrer App das neueste Firebase Crashlytics SDK (oder die Firebase-Materialliste für Android) hinzu. Fügen Sie dann den folgenden Code in die Datei build.gradle.kts oder build.gradle auf Modulebene ein. In Release-Builds (nicht Debug-fähig) ist das Flag standardmäßig aktiviert.

Kotlin

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

Groovig

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

Das Fenster App Quality Insights enthält umfassende Daten mit Informationen zu den Ereignissen, auf die Nutzer stoßen, sowie Links, über die Sie schnell zu den Quellen dieser Ereignisse gelangen können.

Fenster mit App Quality Insights

  1. Wählen Sie im Drop-down-Menü für die Anwendungs-ID die Anwendungs-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 vorliegen, und diese sind nach Ihren größten Abstürzen sortiert.
  3. Sie können sich Ereignisse nach Varianten oder Gruppen von Ereignissen mit ähnlichen Stacktraces ansehen. Die Analyse der Ereignisse nach Variante hilft Ihnen, die Ursachen eines Absturzes zu ermitteln.
  4. Der Bereich mit dem Stacktrace enthält Details zum letzten Auftreten des Ereignisses, bei dem Sie auf den Bereich Probleme geklickt haben. Sie können den Stacktrace des Ereignisses ansehen und darauf klicken, um zu den relevanten Zeilen in Ihrer Codebasis zu springen. Wenn sich der Code seit dem Absturz geändert hat, klicken Sie im Stacktrace neben dem Fehler im Stacktrace auf Unterschied einblenden, um den Unterschied zwischen dem aktuellen Code und der Version der Codebasis anzuzeigen, die den Absturz verursacht hat.

    Option zum Anzeigen des Unterschieds im AQI-Stacktrace.

    Es gibt auch Informationen zum betroffenen Gerätetyp, seine Android-Version und den Zeitpunkt des Ereignisses sowie einen Link zum Ereignis im Firebase Crashlytics-Dashboard. Klicken Sie auf die Schaltfläche Schließen, um ein Problem direkt im Steuerfeld zu schließen.

  5. Im Bereich Details wird die Anzahl der Abstürze nach Gerätetyp und Android-Version aufgeschlüsselt. So kannst du feststellen, welche Nutzergruppen am stärksten betroffen sind. Außerdem wird angezeigt, bei welchen App-Versionen der Absturz aufgetreten ist und wie viele Nutzer betroffen sind.
  6. Lesen Sie Hinweise zu Problemen und hängen Sie sie an, damit sie in der Firebase Console und bei Ihren Teammitgliedern sichtbar sind. Wenn Sie einen Hinweis zu einem Problem schreiben möchten, wählen Sie das Problem aus und öffnen Sie den Bereich Notizen. Zum Schreiben von Notizen benötigen Sie Schreibberechtigungen für das Crashlytics-Projekt. Probleme mit Hinweisen werden mit dem Symbol „Hinweise“ im Bereich Probleme angezeigt.
    Bereich mit Notizen zur App-Qualitätsstatistiken.
  7. Mit den verschiedenen Filtern können Sie sich auf bestimmte Teilmengen von Ereignissen konzentrieren. Du kannst Ereignisse mit schwerwiegenden oder nicht schwerwiegenden Fehlern auswählen oder deren Auswahl aufheben und nach Zeit, App-Version, Crashlytics-Signal, Gerätemarke und -modell sowie Version der Android-Plattform filtern. Für Crashlytics-Signale gilt ein Problem als regressiert, wenn es in der Vergangenheit geschlossen wurde und in einer neuen Version der App wieder aufgetreten ist.

Neben der Möglichkeit, vom Stacktrace zu Code zu wechseln, können Sie auch von Code zu Stacktrace springen: In Android Studio werden Codezeilen, die sich auf Abstürze beziehen, jetzt mit einem Absturzsymbol versehen, damit Sie sie einfach erkennen und debuggen können.

Wenn Sie den Mauszeiger auf das Absturzsymbol bewegen, wird ein Pop-up-Fenster angezeigt, in dem Sie sehen, wie viele Ereignisse diese Codezeile enthalten und wie häufig diese Ereignisse auftreten.

Ereigniszusammenfassung, wenn Sie den Mauszeiger auf das Absturzsymbol bewegen

Klicken Sie auf das Absturzsymbol, 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 zu öffnen.

Ereignisliste, wenn Sie auf das Absturzsymbol klicken

Unterschiedliche Zahlen in Android Vitals und Crashlytics

Beachten Sie, dass Android Vitals und Crashlytics unterschiedliche Werte für die Anzahl der Nutzer und Ereignisse melden, die mit demselben Absturz in Verbindung stehen. Das liegt daran, dass Play und Crashlytics Abstürze zu unterschiedlichen Zeiten und für unterschiedliche Nutzer erkennen können. Im Folgenden finden Sie einige Gründe dafür, warum die Anzahl der Play- und Crashlytics-Anzahl abweichen kann:

  • Google Play erkennt Abstürze, die beim Booten beginnen, 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 Play gemeldet. Crashlytics erfasst jedoch Abstürze gemäß der eigenen Datenschutzerklärung einer App.

Offline mit eingeschränkter Funktionalität prüfen

Wenn Sie eine neue Anfrage senden, z. B. durch Klicken auf Aktualisieren, und Android Studio nicht mit Crashlytics kommunizieren kann, können Sie im Fenster App Quality Insights in den Offlinemodus wechseln.

App Quality Insights ist auch offline verfügbar.

In diesem Modus können Sie weiterhin Probleme und die neuesten Ereignisse anhand von im Cache gespeicherten Daten untersuchen. Bestimmte Funktionen, z. B. das Ändern einiger Filteroptionen oder das Schließen von Problemen, sind nicht verfügbar. Klicken Sie auf Wieder verbinden, um die Verbindung zu Crashlytics wieder herzustellen und zu einem Onlinestatus zurückzukehren.

Option zum erneuten Verknüpfen von App Quality Insights im Offlinemodus.