Premiers pas avec Performance Monitoring pour Flutter

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 : Ajoutez Performance Monitoring à votre application

  1. À partir du répertoire racine de votre projet Flutter, exécutez la commande suivante pour installer le plug-in Flutter Performance Monitoring :

    flutter pub add firebase_performance

  2. À partir du répertoire racine de votre projet Flutter, exécutez la commande suivante :

    flutterfire configure

    L'exécution de cette commande garantit que la configuration Firebase de votre application Flutter est à jour et, pour Android, ajoute le plug-in Gradle Performance Monitoring requis à votre application.

  3. Une fois l'opération terminée, recréez votre projet Flutter :

    flutter run

Une fois que vous avez ajouté le SDK Performance Monitoring, Firebase commence automatiquement à collecter des données liées 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.

Sur Flutter, il n'est pas possible de surveiller automatiquement les performances de rendu d'écran pour les écrans Flutter individuels. Un seul contrôleur de vue encapsule l'intégralité de votre application Flutter de manière native. Le SDK Firebase natif sous-jacent n'est donc pas au courant des transitions d'écran.

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

Firebase commence à traiter les événements lorsque vous ajoutez le SDK à votre application. Si vous êtes encore en phase de développement local, interagissez avec votre application pour générer des événements pour 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 votre application entre l'arrière-plan et le premier plan plusieurs fois, en interagissant avec votre application en naviguant entre les écrans et/ou en déclenchant des requêtes réseau.

  3. Accédez au tableau de bord Performances de la console Firebase. Vos premières données 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) Affichez les messages du journal pour les événements de performances.

  1. Recherchez d'éventuels messages d'erreur dans vos messages de journaux.

    Performance Monitoring ajoute les tags suivants à ses messages de journal pour vous permettre de les filtrer :

    • iOS+ : Firebase/Performance
    • Android : FirebasePerformance

  2. Recherchez les types de journaux suivants, qui indiquent que Performance Monitoring enregistre les événements de performances :

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

  3. 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) 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 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 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ée (et ajoutez les métriques personnalisées souhaitées) à l'aide de l'API fournie par le SDK Performance Monitoring.

Consultez Ajouter une surveillance pour un code spécifique pour en savoir plus sur ces fonctionnalités et sur la façon de les ajouter à votre application.

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

Une fois que vous avez validé Performance Monitoring à l'aide d'un émulateur 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 sur les performances dans le tableau de bord Performances de la console Firebase.

Étapes suivantes