Ce démarrage rapide explique comment configurer Firebase Performance Monitoring pour vous aider à mieux comprendre les caractéristiques de performances de vos applications Flutter.
Avant de commencer
Si ce n'est pas déjà fait, configurez et initialisez Firebase dans votre projet Flutter.
Étape 1: Ajouter la surveillance des performances à votre application
Dans le répertoire racine de votre projet Flutter, exécutez la commande suivante pour installer le plug-in Flutter de surveillance des performances:
flutter pub add firebase_performance
Dans le répertoire racine de votre projet Flutter, exécutez la commande suivante:
flutterfire configure
Exécuter cette commande garantit que la configuration Firebase de votre application Flutter est à jour et, pour Android, ajoute le plug-in Gradle de Performance Monitoring requis à votre application.
Une fois terminé, recréez votre projet Flutter:
flutter run
Une fois que vous avez ajouté le SDK Performance Monitoring, Firebase commence automatiquement à collecter des données sur le cycle de vie de votre application (comme le temps de démarrage de l'application) et des données sur les requêtes réseau HTTP/S.
Sur Flutter, la surveillance automatique des performances de rendu de l'écran n'est pas possible pour les écrans Flutter individuels. Un seul contrôleur de vue encapsule l'ensemble de votre application Flutter de manière native, de sorte que le SDK Firebase natif sous-jacent n'est pas conscient des transitions d'écran.
Étape 2: Générer des événements de performances pour l'affichage initial des données
Firebase commence à traiter les événements lorsque vous avez correctement ajouté le SDK à votre application. Si vous effectuez toujours le développement en local, interagissez avec votre application pour générer des événements afin de collecter et de traiter les données de manière initiale.
Poursuivez le développement de votre application à l'aide d'un simulateur ou d'un appareil de test.
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.
Accédez au tableau de bord "Performances" de la console Firebase. Vos données initiales devraient s'afficher au bout de quelques minutes.
Si vos données initiales ne s'affichent pas, consultez les conseils de dépannage.
Étape 3: (Facultatif) Afficher les messages de journal pour les événements de performances
Recherchez d'éventuels messages d'erreur dans les messages de journal.
Performance Monitoring ajoute les tags suivants à ses messages de journal afin que vous puissiez les filtrer:
- iOS +:
Firebase/Performance
- Android:
FirebasePerformance
- iOS +:
Recherchez les types de journaux suivants, qui indiquent que la surveillance des performances consigne des événements de performances:
Logging trace metric: TRACE_NAME, FIREBASE_PERFORMANCE_CONSOLE_URL
Logging network request trace: URL
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.
É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ée est sa durée, mais vous pouvez également ajouter des métriques personnalisées, telles que les éventuelles requêtes du 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ée (et ajoutez les métriques personnalisées souhaitées) à l'aide de l'API fournie par le SDK de surveillance des performances.
Consultez Ajouter la surveillance d'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
Une fois que vous avez validé la surveillance des performances à l'aide d'un émulateur et d'un ou de 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 sur les performances dans le tableau de bord "Performances" de la console Firebase.
Étapes suivantes
En savoir plus sur les données collectées automatiquement par la surveillance des performances:
- Données liées au cycle de vie de votre application, comme le temps de démarrage de l'application
- Données sur les requêtes réseau HTTP/S émises par votre application
Affichez, suivez et filtrez vos données de performances dans la console Firebase.
Ajoutez la surveillance de tâches ou de workflows spécifiques dans votre application en instrumentant des traces de code personnalisées.