Erste Schritte mit der Leistungsüberwachung für Flutter

In dieser Kurzanleitung wird beschrieben, wie Sie Firebase Performance Monitoring einrichten, um Einblicke in die Leistungsmerkmale Ihrer Flutter-Apps zu erhalten.

Hinweis

Konfigurieren und initialisieren Sie Firebase in Ihrem Flutter Projekt, falls noch nicht geschehen.

Schritt 1: Performance Monitoring in der App hinzufügen

  1. Führen Sie im Stammverzeichnis Ihres Flutter-Projekts den folgenden Befehl aus, um das Performance Monitoring Flutter-Plug-in zu installieren:

    flutter pub add firebase_performance

  2. Führen Sie im Stammverzeichnis Ihres Flutter-Projekts den folgenden Befehl aus:

    flutterfire configure

    Mit diesem Befehl wird sichergestellt, dass die Firebase-Konfiguration Ihrer Flutter-App auf dem neuesten Stand ist. Bei Android-Apps wird außerdem das erforderliche Performance Monitoring Gradle-Plug-in hinzugefügt.

  3. Erstellen Sie das Flutter-Projekt noch einmal:

    flutter run

Nachdem Sie das Performance Monitoring SDK hinzugefügt haben, erfasst Firebase automatisch Daten zum Lebenszyklus Ihrer App (z. B. zur Startzeit) und Daten für HTTP/S-Netzwerkanfragen.

Bei Flutter ist die automatische Leistungsüberwachung der Bildschirmwiedergabe für einzelne Flutter-Bildschirme nicht möglich. Ein einzelner Ansichtscontroller kapselt Ihre gesamte Flutter-Anwendung nativ, sodass das zugrunde liegende native Firebase SDK keine Bildschirmübergänge erkennt.

Schritt 2: Leistungsereignisse für die erste Datenanzeige generieren

Firebase beginnt mit der Verarbeitung der Ereignisse, wenn Sie das SDK erfolgreich in Ihre App eingebunden haben. Wenn Sie noch lokal entwickeln, interagieren Sie mit Ihrer App, um Ereignisse für die erste Datenerhebung und -verarbeitung zu generieren.

  1. Entwickeln Sie Ihre App mit einem Simulator oder Testgerät weiter.

  2. Generieren Sie Ereignisse, indem Sie Ihre App mehrmals zwischen Hintergrund und Vordergrund wechseln, mit der App interagieren, indem Sie zwischen Bildschirmen navigieren, und/oder Netzwerkanfragen auslösen.

  3. Rufen Sie das Performance Dashboard der Firebase Console auf. Die ersten Daten sollten innerhalb weniger Minuten angezeigt werden.

    Wenn die ersten Daten nicht angezeigt werden, lesen Sie die Tipps zur Fehlerbehebung.

Schritt 3: (Optional) Logmeldungen für Leistungsereignisse ansehen

  1. Prüfen Sie die Logmeldungen auf Fehlermeldungen.

    Performance Monitoring kennzeichnet Logmeldungen mit den folgenden Tags, damit Sie sie filtern können:

    • iOS+: Firebase/Performance
    • Android: FirebasePerformance

  2. Prüfen Sie, ob die folgenden Arten von Logs vorhanden sind. Sie zeigen an, dass Performance Monitoring Leistungsereignisse protokolliert:

    • Logging trace metric: TRACE_NAME, FIREBASE_PERFORMANCE_CONSOLE_URL
    • Logging network request trace: URL

  3. Klicken Sie auf die URL, um Ihre Daten in der Firebase Console anzusehen. Es kann einige Augenblicke dauern, bis die Daten im Dashboard aktualisiert werden.

Schritt 4: (Optional) Benutzerdefiniertes Monitoring für bestimmten Code hinzufügen

Wenn Sie Leistungsdaten für bestimmten Code in Ihrer App beobachten möchten, können Sie benutzerdefinierte Code-Traces instrumentieren.

Mit einem benutzerdefinierten Code-Trace können Sie messen, wie lange es dauert, bis Ihre App eine bestimmte Aufgabe oder eine Reihe von Aufgaben erledigt hat, z. B. eine Reihe von Bildern geladen oder eine Datenbank abgefragt hat. Die Standardmessung für einen benutzerdefinierten Code-Trace ist die Dauer. Sie können aber auch benutzerdefinierte Messungen hinzufügen, z. B. Cache-Treffer und Warnungen zum Arbeitsspeicher.

In Ihrem Code definieren Sie den Anfang und das Ende eines benutzerdefinierten Code-Traces und fügen alle gewünschten benutzerdefinierten Messungen hinzu. Dazu verwenden Sie die API, die vom Performance Monitoring SDK bereitgestellt wird.

Weitere Informationen zu diesen Funktionen und dazu, wie Sie sie Ihrer App hinzufügen, finden Sie unter Monitoring für bestimmten Code hinzufügen.

Schritt 5: App bereitstellen und Ergebnisse prüfen

Nachdem Sie Performance Monitoring mit einem Emulator und einem oder mehreren Testgeräten validiert haben, können Sie die aktualisierte Version Ihrer App für Ihre Nutzer bereitstellen.

Sie können Leistungsdaten im Performance Dashboard der Firebase Console beobachten.

Nächste Schritte