Check out what’s new from Firebase@ Google I/O 2021, and join our alpha program for early access to the new Remote Config personalization feature. Learn more

Erste Schritte mit Leistungsüberwachung für iOS

Bevor Sie beginnen

Falls noch nicht geschehen , fügen Sie Firebase zu Ihrem iOS-Projekt hinzu .

Schritt 1 : Leistungsüberwachung zu Ihrer App hinzufügen

Nachdem Sie das Performance - Monitoring - SDK hinzugefügt haben, Firebase startet automatisch Daten für App-Sammelbild - Wiedergabe , auf dem App - Lebenszyklus bezogenen Daten (wie App - Startzeit ) und Daten für HTTP / S Netzwerkanforderungen .

  1. Öffnen Sie die Pod-Datei, die Sie für das Projekt erstellt haben (oder führen Sie pod init , um eine zu erstellen), und fügen Sie dann die folgende Zeile in den Zielabschnitt ein:

    pod 'Firebase/Performance'
  2. Führen Sie im Verzeichnis Ihrer Poddatei den folgenden Befehl aus, um das Performance Monitoring SDK zu installieren:

    pod install
  3. Öffnen Sie die .xcworkspace Datei mit Xcode.

  4. Importieren Sie das Firebase-Modul in Ihr UIApplicationDelegate :

    Schnell

    import Firebase

    Ziel c

    @import Firebase;
  5. Konfigurieren Sie eine freigegebene FirebaseApp Instanz, normalerweise in der application:didFinishLaunchingWithOptions: -Methode Ihrer App:

    Schnell

    // Use Firebase library to configure APIs
    FirebaseApp.configure()

    Ziel c

    // Use Firebase library to configure APIs
    [FIRApp configure];
  6. Kompilieren Sie Ihre App neu.

Schritt 2 : Generieren von Leistungsereignissen für die anfängliche Datenanzeige

Firebase beginnt mit der Verarbeitung der Ereignisse, wenn Sie das SDK erfolgreich zu Ihrer App hinzugefügt haben. Wenn Sie noch lokal entwickeln, interagieren Sie mit Ihrer App, um Ereignisse für die anfängliche Datenerfassung 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 Ihrer App interagieren, indem Sie über Bildschirme navigieren und/oder Netzwerkanfragen auslösen.

  3. Rufen Sie das Leistungs- Dashboard der Firebase-Konsole auf. Sie sollten innerhalb weniger Minuten Ihre erste Datenanzeige sehen.

    Wenn Ihre Anfangsdaten nicht angezeigt werden, lesen Sie die Tipps zur Fehlerbehebung .

Schritt 3 : (Optional) Protokollnachrichten für Leistungsereignisse anzeigen

  1. Aktivieren Sie die Debug-Protokollierung wie folgt:

    1. Wählen Sie in Xcode (mindestens v12.2) Produkt > Schema > Schema bearbeiten aus .
    2. Wählen Sie im linken Menü Ausführen und dann die Registerkarte Argumente aus .
    3. -FIRDebugEnabled Abschnitt Beim -FIRDebugEnabled Argumente den -FIRDebugEnabled .
  2. Überprüfen Sie Ihre Protokollnachrichten auf Fehlermeldungen.

  3. Die Leistungsüberwachung kennzeichnet seine Protokollnachrichten mit Firebase/Performance damit Sie Ihre Protokollnachrichten filtern können.

  4. Suchen Sie nach den folgenden Protokolltypen, die darauf hinweisen, dass die Leistungsüberwachung Leistungsereignisse protokolliert:

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

Wenn Ihre App keine Leistungsereignisse protokolliert, lesen Sie die Tipps zur Fehlerbehebung .

Schritt 4 : (Optional) Benutzerdefinierte Überwachung für bestimmten Code hinzufügen specific

Um Leistungsdaten zu überwachen, die mit einem bestimmten Code in Ihrer App verknüpft sind, können Sie benutzerdefinierte Code-Traces instrumentieren.

Mit einer benutzerdefinierten Codeablaufverfolgung können Sie messen, wie lange Ihre App benötigt, um eine bestimmte Aufgabe oder einen Satz von Aufgaben abzuschließen, z. B. das Laden einer Reihe von Bildern oder das Abfragen Ihrer Datenbank. Die Standardmetrik für einen benutzerdefinierten Codetrace ist die Dauer, aber Sie können auch benutzerdefinierte Metriken wie Cache-Treffer und Speicherwarnungen hinzufügen.

In Ihrem Code definieren Sie den Anfang und das Ende eines benutzerdefinierten Code-Trace (und fügen beliebige benutzerdefinierte Metriken hinzu), indem Sie die vom Performance Monitoring SDK bereitgestellte API verwenden.

Besuchen Sie Überwachung für spezifischen Code hinzufügen, um mehr über diese Funktionen zu erfahren und wie Sie sie zu Ihrer App hinzufügen.

Schritt 5 : Stellen Sie Ihre App bereit und überprüfen Sie die Ergebnisse.

Nachdem Sie die Leistungsüberwachung mit dem Xcode-Simulator und einem oder mehreren Testgeräten validiert haben, können Sie die aktualisierte Version Ihrer App für Ihre Benutzer bereitstellen.

Sie können Leistungsdaten im Leistungs- Dashboard der Firebase-Konsole überwachen.

Bekannte Probleme

  • Die Leistungsüberwachung weist bekannte Kompatibilitätsprobleme mit GTMSQLite auf. Wir empfehlen, die Leistungsüberwachung nicht mit Apps zu verwenden, die GTMSQLite verwenden.
  • Das Umschalten der Methode nach dem Aufrufen von FirebaseApp.configure() kann das Performance Monitoring SDK beeinträchtigen.
  • Bekannte Probleme mit dem iOS 8.0-8.2-Simulator verhindern, dass die Leistungsüberwachung Leistungsereignisse erfasst. Diese Probleme werden im iOS 8.3 Simulator und späteren Versionen behoben.
  • Verbindungen, die mit der backgroundSessionConfiguration von NSURLSession hergestellt werden, weisen längere Verbindungszeiten auf als erwartet. Diese Verbindungen werden außerhalb des Prozesses ausgeführt und die Timings spiegeln prozessinterne Callback-Ereignisse wider.

Nächste Schritte