Premiers pas avec Performance Monitoring pour les plates-formes Apple

Avant de commencer

Si ce n'est pas déjà fait, Ajoutez Firebase à votre projet Apple.

Étape 1: Ajoutez Performance Monitoring à votre application

Une fois que vous avez ajouté le SDK Performance Monitoring, Firebase commence automatiquement à collecter des données pour le rendu à l'écran de votre application, des données liées au cycle de vie de votre application (comme l'heure de démarrage de l'application) et des données pour les requêtes réseau HTTP/S.

Utilisez Swift Package Manager pour installer et gérer les dépendances Firebase.

  1. Dans Xcode, ouvrez le projet de votre application, puis accédez à File > Ajouter des packages.
  2. Lorsque vous y êtes invité, ajoutez le dépôt du SDK des plates-formes Firebase pour Apple :
  3.   https://github.com/firebase/firebase-ios-sdk.git
  4. Sélectionnez la bibliothèque Performance Monitoring.
  5. Ajoutez l'indicateur -ObjC à la section Other Linker Flags (Autres indicateurs Linker) des paramètres de compilation de votre cible.
  6. Lorsque vous avez terminé, Xcode commence à résoudre et à télécharger automatiquement vos dépendances en arrière-plan.

Configurez ensuite le module Firebase:

  1. Importez le module FirebaseCore dans votre UIApplicationDelegate, ainsi que toute autre Modules Firebase que votre délégué d'application utilise. Par exemple, pour utiliser Cloud Firestore et 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. Configurez un FirebaseApp l'instance partagée dans le bucket du délégué Méthode 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. Si vous utilisez SwiftUI, vous devez créer un délégué d'application et l'associer à votre struct App via UIApplicationDelegateAdaptor ou NSApplicationDelegateAdaptor. Vous devez également désactiver le mélange des délégués d'application. Pour Pour en savoir plus, consultez les instructions de SwiftUI.

    SwiftUI

    @main
    struct YourApp: App {
      // register app delegate for Firebase setup
      @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
    
      var body: some Scene {
        WindowGroup {
          NavigationView {
            ContentView()
          }
        }
      }
    }
          
  4. Recompilez votre application.

Étape 2: Générez des événements liés aux performances pour l'affichage initial des données

Firebase commence à traiter les événements une fois que vous avez ajouté le SDK à votre l'application. Si vous développez encore en local, interagissez avec votre appli pour générer pour la collecte et le traitement initiaux des données.

<ph type="x-smartling-placeholder">
    </ph>
  1. Poursuivez le développement de votre application à l'aide d'un simulateur ou d'un appareil de test.

  2. Générez des événements en basculant votre application entre l'arrière-plan et l'avant-plan plusieurs fois, en interagissant avec votre application en parcourant les écrans et/ou en déclenchant des requêtes réseau.

  3. Accédez au tableau de bord des performances de la console Firebase. Vos données initiales doivent s'afficher dans quelques minutes.

    Si vous ne voyez pas vos données initiales, consultez la section conseils.

Étape 3: (Facultatif) Affichez les messages de journal pour les événements liés aux performances

  1. Activez la journalisation du débogage comme suit :

    1. Dans Xcode (version 15.2 ou ultérieure), sélectionnez Produit > Schéma > Modifier le schéma
    2. Sélectionnez Exécuter dans le menu de gauche, puis l'onglet Arguments.
    3. Dans la section Arguments transmis lors du lancement, ajoutez -FIRDebugEnabled.
  2. Recherchez d'éventuels messages d'erreur dans les messages de journal.

  3. Performance Monitoring ajoute un tag Firebase/Performance à ses messages de journal pour que vous puissiez peuvent filtrer vos messages de journal.

  4. Recherchez les types de journaux suivants, qui indiquent que Performance Monitoring consigne des événements de performances :

    • Logging trace metric: TRACE_NAME, FIREBASE_PERFORMANCE_CONSOLE_URL
    • Logging network request trace: URL
  5. Cliquez sur l'URL pour afficher vos données dans la console Firebase. Cela peut prendre quelques des moments pour que les données soient mises à jour dans le tableau de bord.

Si votre application n'enregistre pas les événements liés aux performances, consultez le guide de dépannage conseils.

Étape 4: (Facultatif) Ajouter une surveillance personnalisée pour un code spécifique

Pour surveiller les données de performances associées à un code spécifique de votre application, vous pouvez instrumenter des traces de code personnalisées.

Avec une trace de code personnalisée, vous pouvez mesurer le temps nécessaire à votre application pour effectuer une tâche ou un ensemble de tâches spécifiques, comme charger un ensemble d'images ou interroger votre base de données. La métrique par défaut d'une trace de code personnalisé est sa durée, mais vous pouvez également ajouter des métriques personnalisées, telles que des succès de cache et des avertissements concernant la mémoire.

Dans votre code, vous définissez le début et la fin d'une trace de code personnalisé (et ajouter les métriques personnalisées de votre choix) à l'aide de l'API fournie par le SDK Performance Monitoring.

Consultez Ajouter la surveillance pour un code spécifique. pour en savoir plus sur ces fonctionnalités et découvrir comment les ajouter à votre application.

Étape 5 : Déployez votre application, puis examinez les résultats

Après avoir validé Performance Monitoring à l'aide du simulateur Xcode et d'un ou plusieurs des appareils de test, vous pouvez déployer la version mise à jour de votre application sur les appareils de vos utilisateurs.

Vous pouvez surveiller les données sur les performances dans le tableau de bord des performances de la console Firebase.

Problèmes connus

  • Performance Monitoring présente des problèmes de compatibilité connus avec GTMSQLite. Nous vous déconseillons à l'aide de Performance Monitoring avec des applications qui utilisent GTMSQLite.
  • Le défilement de la méthode après l'appel de FirebaseApp.configure() peut interférer avec le SDK Performance Monitoring.
  • Les problèmes connus liés au simulateur iOS 8.0 à 8.2 empêchent Performance Monitoring des événements liés aux performances. Ces problèmes sont résolus dans le simulateur iOS 8.3 et versions ultérieures.
  • Connexions établies à l'aide du paramètre backgroundSessionConfiguration de NSURLSession les temps de connexion sont plus longs que prévu. Ces connexions sont exécutées hors processus et les durées reflètent les événements de rappel en cours.

Étapes suivantes