Erste Schritte mit der Leistungsüberwachung für Apple-Plattformen

Hinweis

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

Schritt 1: Performance Monitoring zu Ihrer App hinzufügen

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

Verwenden Sie Swift Package Manager, um Firebase-Abhängigkeiten zu installieren und zu verwalten.

  1. Öffnen Sie Ihr App-Projekt und gehen Sie in Xcode zu File > Add Packages (Datei > Pakete hinzufügen).
  2. Fügen Sie bei entsprechender Aufforderung das Firebase Apple Platforms SDK-Repository hinzu:
    3.   https://github.com/firebase/firebase-ios-sdk.git
  3. Wählen Sie die Performance Monitoring-Bibliothek aus.
  4. Fügen Sie in den Build-Einstellungen des Ziels im Bereich Other Linker Flags das Flag -ObjC hinzu.
  5. Wenn Sie fertig, beginnt Xcode automatisch, Ihre Abhängigkeiten im Hintergrund aufzulösen und herunterzuladen.

Konfigurieren Sie als Nächstes das Firebase-Modul:

  1. Importieren Sie das FirebaseCore-Modul in Ihre UIApplicationDelegate sowie alle anderen Firebase-Module, die Ihr App-Delegat verwendet. So verwenden Sie beispielsweise Cloud Firestore und Authentication:

    SwiftUI

    import SwiftUI
import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Swift

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Objective-C

    @import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
  2. Konfigurieren Sie ein FirebaseApp freigegebene Instanz im Methode application(_:didFinishLaunchingWithOptions:):

    SwiftUI

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

    Swift

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

    Objective-C

    // Use Firebase library to configure APIs
[FIRApp configure];
  3. Wenn Sie SwiftUI verwenden, müssen Sie einen Anwendungsdelegierten erstellen und diesen anhängen. zu deiner App-Struktur über UIApplicationDelegateAdaptor oder NSApplicationDelegateAdaptor Außerdem müssen Sie App Delegate Swizzling deaktivieren. Für Weitere Informationen finden Sie in der SwiftUI-Anleitung.

    SwiftUI

    @main
struct YourApp: App {
  // register app delegate for Firebase setup
  @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}

  4. Kompilieren Sie die App neu.

Schritt 2: Leistungsereignisse für die erste Datenanzeige generieren

Firebase beginnt mit der Verarbeitung der Ereignisse, sobald Sie das SDK Ihrer App hinzugefügt haben. Wenn Sie noch lokal entwickeln, interagieren Sie mit Ihrer App, um Ereignisse für die anfängliche Datenerhebung und -verarbeitung zu generieren.

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

  2. Ereignisse durch Wechseln der App zwischen Hintergrund und Vordergrund generieren durch das Wechseln zwischen Bildschirmen mit Ihrer App interagieren, und/oder Netzwerkanfragen auslösen.

  3. Rufen Sie das Dashboard Leistungs auf. der Firebase-Konsole. Die erste Datenanzeige sollte innerhalb ein paar Minuten.

    Wenn Ihre ursprünglichen Daten nicht angezeigt werden, lesen Sie die Fehlerbehebung Tipps

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

  1. So aktivieren Sie die Debug-Protokollierung:

    1. Wählen Sie in Xcode (mindestens Version 15.2) Product > Scheme > Edit scheme aus.
    2. Wählen Sie im Menü auf der linken Seite Ausführen und dann den Tab Argumente aus.
    3. Fügen Sie im Abschnitt Beim Start übergebene Argumente -FIRDebugEnabled hinzu.

  2. Prüfen Sie Ihre Logeinträge auf Fehlermeldungen.

  3. Performance Monitoring kennzeichnet seine Logeinträge mit Firebase/Performance, sodass Sie können Sie Ihre Logeinträge filtern.

  4. Prüfen Sie, ob die folgenden Arten von Protokollen vorhanden sind, die darauf hinweisen, dass Performance Monitoring 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 Console aufzurufen. Es kann einige Zeit dauern, bis die Daten im Dashboard aktualisiert werden.

Wenn in Ihrer App keine Leistungsereignisse protokolliert werden, lesen Sie die Tipps zur Fehlerbehebung.

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

Um Leistungsdaten im Zusammenhang mit einem bestimmten Code in Ihrer App zu beobachten, können Sie benutzerdefinierte Code-Traces instrumentieren.

Mit einem benutzerdefinierten Code-Trace können Sie messen, wie lange es dauert, bis Ihre App abgeschlossen ist. eine bestimmte Aufgabe oder eine Reihe von Aufgaben, wie das Laden einer Reihe von Bildern oder das Abfragen von in Ihrer Datenbank. Der Standardmesswert für einen benutzerdefinierten Code-Trace ist seine Dauer. Sie können aber auch benutzerdefinierte Messwerte wie Cachetreffer und Speicherwarnungen hinzufügen.

In Ihrem Code definieren Sie den Anfang und das Ende eines benutzerdefinierten Code-Trace (und Fügen Sie die gewünschten benutzerdefinierten Messwerte hinzu. Verwenden Sie dazu die vom Performance Monitoring SDK bereitgestellte API.

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

Schritt 5: Anwendung bereitstellen und Ergebnisse prüfen

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

Sie können die Leistungsdaten in der Dashboard zur Leistungsüberwachung der Firebase-Konsole.

Bekannte Probleme

  • Performance Monitoring hat bekannte Kompatibilitätsprobleme mit GTMSQLite. Wir empfehlen, Performance Monitoring mit Apps verwenden, die GTMSQLite nutzen.
  • Das Verschieben der Methode nach dem Aufrufen von FirebaseApp.configure() kann folgende Auswirkungen haben: das Performance Monitoring SDK.
  • Aufgrund bekannter Probleme mit dem iOS 8.0–8.2-Simulator können mit Performance Monitoring keine Leistungsereignisse erfasst werden. Diese Probleme sind im iOS 8.3-Simulator behoben. und höheren Versionen.
  • Mit backgroundSessionConfiguration von NSURLSession hergestellte Verbindungen länger als erwartet die Verbindungszeiten haben wird. Diese Verbindungen sind ausgeführt wurden und die Zeitangaben in Bearbeitung befindliche Callback-Ereignisse widerspiegeln.

Nächste Schritte