Démarrer avec la surveillance des performances pour Flutter

Ce guide de démarrage rapide décrit comment configurer la surveillance des performances de Firebase pour vous aider à mieux comprendre les caractéristiques de performances de vos applications Flutter.

Avant que tu commences

Si vous ne l'avez pas déjà fait, configurez et initialisez Firebase dans votre projet Flutter.

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

  1. Depuis le répertoire racine de votre projet Flutter, exécutez la commande suivante pour installer le plugin Performance Monitoring Flutter :

    flutter pub add firebase_performance

  2. Depuis le 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 Performance Monitoring Gradle requis à votre application.

  3. Une fois terminé, reconstruisez votre projet Flutter :

    flutter run

Une fois que vous avez ajouté le SDK de surveillance des performances, Firebase commence automatiquement à collecter des données relatives 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 .

Sur Flutter, la surveillance automatique des performances de rendu d'écran n'est pas possible pour les écrans Flutter individuels. Un seul contrôleur de vue encapsule l'intégralité de votre application Flutter de manière native afin que le SDK Firebase natif sous-jacent ne soit pas conscient des transitions d'écran.

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

Firebase commence à traiter les événements lorsque vous ajoutez avec succès le SDK à votre application. Si vous développez encore 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 des performances de la console Firebase. Vous devriez voir vos données initiales s'afficher dans quelques minutes.

    Si vous ne voyez pas d'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. Vérifiez vos messages de journal pour tout message d'erreur.

    Performance Monitoring marque ses messages de journal avec les balises suivantes afin que vous puissiez filtrer vos messages de journal :

    • iOS+ : Firebase/Performance
    • Android : FirebasePerformance

  2. Recherchez les types de journaux suivants qui indiquent que la surveillance des performances consigne 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 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 d'un suivi de code personnalisé est sa durée, mais vous pouvez également ajouter des métriques personnalisées, telles que des accès au cache et des 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.

Visitez 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

Après avoir 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 de performances dans le tableau de bord des performances de la console Firebase.

Prochaines étapes