Google 致力于为黑人社区推动种族平等。查看具体举措。

Premiers pas avec la surveillance des performances pour iOS

Avant que tu commences

Si vous avez pas déjà, ajoutez Firebase à votre projet iOS .

Étape 1: Ajouter Contrôle des performances à votre application

Une fois que vous avez ajouté le SDK de suivi de la performance, Firebase démarre automatiquement la collecte de données pour votre application de rendu de l' écran , les données relatives au cycle de vie de votre application (comme le temps de démarrage de l' application ), et des données pour les requêtes réseau HTTP / S .

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

    pod 'Firebase/Performance'

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

    pod install

  3. Ouvrez le .xcworkspace fichier en utilisant Xcode.

  4. Importer le module Firebase dans votre UIApplicationDelegate :

    Rapide

    import Firebase

    Objectif c

    @import Firebase;
  5. Configurer une FirebaseApp instance partagée, généralement dans votre application application:didFinishLaunchingWithOptions: méthode:

    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 des données initiales

Firebase commence à traiter les événements lorsque vous ajoutez avec succès le SDK à votre application. Si vous développez toujours localement, interagissez avec votre application pour générer des événements pour la collecte et le traitement initiaux des données.

  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 de performance de la console Firebase. Vous devriez voir vos données initiales s'afficher dans quelques minutes.

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

Étape 3: (Facultatif) Voir les messages du journal d'événements de performance

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

    1. Dans Xcode (v12.2 de minimum), sélectionnez Produit> Système> Modifier schéma.
    2. Sélectionnez Exécuter dans le menu de gauche, puis sélectionnez l'onglet Arguments.
    3. Dans les arguments transmis à la section de lancement, ajoutez -FIRDebugEnabled .

  2. Vérifiez vos messages de journal pour tout message d'erreur.

  3. Performance des balises de surveillance de ses messages journaux avec Firebase/Performance afin que vous pouvez filtrer vos messages journaux.

  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 , FIREBASE_PERFORMANCE_CONSOLE_URL
    • Logging network request trace: URL

  5. Cliquez sur l'URL pour afficher vos données dans la console Firebase. La mise à jour des données dans le tableau de bord peut prendre quelques instants.

Si votre application n'est pas des événements de performance logging, consultez les conseils de dépannage .

Étape 4: (Facultatif) Ajouter le suivi personnalisé pour le code spécifique

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

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écifiques, 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é 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 kit de développement logiciel de surveillance des performances.

Visite Ajouter le suivi pour le code spécifique pour en savoir plus sur ces caractéristiques et comment les ajouter à votre application.

Étape 5: Déployer votre application puis des résultats d'examen

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 pour vos utilisateurs.

Vous pouvez surveiller les données de performance dans le tableau de bord de performance 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.
  • Méthode swizzling après avoir appelé FirebaseApp.configure() peut interférer avec le SDK suivi de la performance.
  • Des problèmes connus avec le simulateur iOS 8.0-8.2 empêchent la surveillance des performances de capturer les événements de performances. 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 minutages reflètent les événements de rappel en cours.

Prochaines étapes