Cette page a été traduite par l'API Cloud Translation.
Switch to English

Démarrez avec la surveillance des performances pour iOS

Avant que tu commences

Si vous ne l'avez pas déjà fait, ajoutez Firebase à votre projet iOS .

Étape 1 : Ajoutez la surveillance des performances à votre application

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

  1. Ouvrez le podfile que vous avez créé pour le projet (ou exécutez pod init pour en créer un), puis ajoutez la ligne suivante dans la section cible:

    pod 'Firebase/Performance'
  2. Dans le répertoire de votre podfile, exécutez la commande suivante pour installer le SDK Performance Monitoring:

    pod install
  3. Ouvrez le fichier .xcworkspace à l'aide de Xcode.

  4. Importez le module Firebase dans votre UIApplicationDelegate :

    Rapide

    import Firebase

    Objectif c

    @import Firebase;
  5. Configurez une instance partagée FirebaseApp , généralement dans l'application de votre application:didFinishLaunchingWithOptions: method:

    Rapide

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

    Objectif c

    // Use Firebase library to configure APIs
    [FIRApp configure];
  6. Recompilez votre application.

Étape 2 : générer des événements de performance pour l'affichage initial des données

Firebase peut détecter que vous avez ajouté avec succès le SDK à votre application lorsqu'il reçoit des informations sur les événements (comme les interactions avec les applications) de votre application. Si vous développez encore localement, interagissez avec votre application pour générer des événements pour la détection du SDK ainsi que la collecte et le traitement des données initiales.

  1. Continuez à développer votre application à l'aide d'un simulateur ou d'un appareil de test.

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

  3. Accédez au tableau de bord Performances de la console Firebase pour voir si Firebase a détecté le SDK.

    Si vous ne voyez pas le message "SDK détecté", consultez les conseils de dépannage .

  4. La surveillance des performances traite les données des événements de performances avant de les afficher dans le tableau de bord des performances . Vous devriez voir l'affichage initial de vos données dans les 24 heures suivant l'affichage du message de détection du SDK.

    Si vous ne voyez pas l'affichage de vos données initiales, consultez les conseils de dépannage .

Étape 3 : (Facultatif) Afficher les messages du journal pour les événements de performance

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

    1. Dans Xcode (v11.0 minimum), sélectionnez Produit > Schéma > Modifier le schéma .
    2. Sélectionnez Exécuter dans le menu de gauche, puis sélectionnez l'onglet Arguments .
    3. Dans la section Arguments transmis lors du lancement , ajoutez -FIRDebugEnabled .
  2. Vérifiez vos messages de journal pour tout message d'erreur.

  3. La surveillance des performances marque ses messages de journal avec Firebase/Performance afin que vous puissiez filtrer vos messages de journal.

  4. Recherchez les types de journaux suivants qui indiquent que la surveillance des performances enregistre les événements de performances:

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

Si votre application n'enregistre pas les événements de performances, consultez les conseils de dépannage .

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

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

Avec une trace de code personnalisée, vous pouvez mesurer le temps qu'il faut à votre application pour effectuer une tâche ou un ensemble de tâches spécifique, comme le chargement d'un ensemble d'images ou l'interrogation de votre base de données. La métrique par défaut pour une trace de code personnalisée est sa durée, mais vous pouvez également ajouter des métriques personnalisées, telles que les accès au cache et les avertissements de mémoire.

Dans votre code, vous définissez le début et la fin d'une trace de code personnalisé (et ajoutez les métriques personnalisées souhaitées) à l'aide de l'API fournie par le SDK de surveillance des performances.

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

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

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

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

Problèmes connus

  • La surveillance des performances a des problèmes de compatibilité connus avec GTMSQLite. Nous vous recommandons de ne pas utiliser la surveillance des performances avec les applications qui utilisent GTMSQLite.
  • La rotation de la méthode après l'appel de FirebaseApp.configure() peut interférer avec le SDK de surveillance des performances.
  • Des problèmes connus avec le simulateur iOS 8.0-8.2 empêchent la surveillance des performances de capturer les événements de performance. Ces problèmes sont résolus dans le simulateur iOS 8.3 et les versions ultérieures.
  • Connexions établies à l' aide de NSURLSession backgroundSessionConfiguration exposeront plus de temps de connexion prévus. Ces connexions sont exécutées hors processus et les délais reflètent les événements de rappel en cours.

Prochaines étapes