Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

Erste Schritte mit Leistungsüberwachung für iOS

Bevor Sie beginnen

Wenn Sie nicht bereits haben, fügen Sie Firebase zu Ihrem iOS - Projekt .

Schritt 1: Fügen Leistungsüberwachung Ihrer App

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 podfile Sie für das Projekt erstellt (oder Lauf pod init erstellen), dann fügen Sie die folgende Zeile innerhalb des Zielabschnitts:

    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 die Firebase Modul in Ihrem UIApplicationDelegate :

    Schnell

    import Firebase

    Ziel c

    @import Firebase;
  5. Konfigurieren ein FirebaseApp gemeinsame Instanz, in der Regel in Ihrem App - application:didFinishLaunchingWithOptions: Methode:

    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 Leistungsereignisse 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. Gehen Sie auf die Performance - Dashboard der Konsole Firebase. Sie sollten innerhalb weniger Minuten Ihre erste Datenanzeige sehen.

    Wenn Sie nicht über eine Anzeige Ihrer ersten Daten, die überprüfen Tipps zur Fehlerbehebung .

Schritt 3: (Optional) Ansicht Log - Meldungen für Performance - Events

  1. Aktivieren Sie die Debug-Protokollierung wie folgt:

    1. In Xcode (mindestens v12.2), wählen Sie Product> Schema> Schema bearbeiten.
    2. Wählen Sie Run aus dem linken Menü, wählen Sie dann die Registerkarte Argumente.
    3. In den übergebenen Argumenten auf Abschuss Abschnitt Add -FIRDebugEnabled .
  2. Überprüfen Sie Ihre Protokollnachrichten auf Fehlermeldungen.

  3. Performance - Monitoring - Tags seine Log - Meldungen mit Firebase/Performance , so dass Sie Ihre Log - Meldungen filtern.

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

    • Logging trace metric: TRACE_NAME , FIREBASE_PERFORMANCE_CONSOLE_URL
    • Logging network request trace: URL
  5. Klicken Sie auf die URL, um Ihre Daten in der Firebase-Konsole anzuzeigen. Es kann einen Moment dauern, bis die Daten im Dashboard aktualisiert werden.

Wenn Ihre App nicht Performance - Events anmelden, die überprüfen Tipps zur Fehlerbehebung .

Schritt 4: (Optional) Fügen Sie die Überwachung speziell für spezifischen Code

Leistungsdaten mit spezifischem Code in Ihrer Anwendung verbunden zu überwachen, können Sie Instrument benutzerdefinierten Code Spuren .

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.

Besuche hinzu spezifische Code Überwachung mehr über diese Funktionen zu erfahren , und wie sie zu Ihrer Anwendung hinzuzufügen.

Schritt 5: Stellen Sie Ihre App dann als Ergebnis hieraus

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 in der Überwachung der Performance - Dashboard der Konsole Firebase.

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.
  • Verfahren Swizzling nach dem Aufruf FirebaseApp.configure() könnte mit der Leistungsüberwachung SDK stören.
  • 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.
  • NSURLSession die Verwendung von Verbindungen hergestellt backgroundSessionConfiguration werden zeigen länger als erwartete Verbindungszeiten. Diese Verbindungen werden außerhalb des Prozesses ausgeführt und die Timings spiegeln prozessinterne Callback-Ereignisse wider.

Nächste Schritte