Google est engagé à faire progresser l'équité raciale pour les communautés noires. Regarde comment.
Cette page a été traduite par l'API Cloud Translation.
Switch to English

Commencez avec Suivi des performances pour Android

Avant que tu commences

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

Dans votre niveau de projet build.gradle file , assurez - vous d'inclure le référentiel Maven de Google à la fois votre buildscript et allprojects sections.

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

Le SDK de suivi des performances permet le suivi des traces de durée automatique et des autres traces sur mesure dans votre application.

  1. Dans votre module (app-niveau) de fichier Gradle (généralement app/build.gradle ):

    // ...
    
    dependencies {
      // ...
    
      // Add the dependency for the Performance Monitoring library
      implementation 'com.google.firebase:firebase-perf:19.0.8'
    }
    
  2. Recompiler votre application.

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

Le module de surveillance de performance Gradle permet instrumentation qui fournit le traitement d'annotation @AddTrace et la surveillance de la demande de réseau HTTP / S automatique .

Pour ajouter le plug - in Performance surveillance à votre application:

  1. Dans votre module (app-niveau) de fichier Gradle (généralement app/build.gradle ), appliquer le plug - in suivi de la performance:

    apply plugin: 'com.android.application'
    apply plugin: 'com.google.gms.google-services'
    // Apply the Performance Monitoring plugin
    apply plugin: 'com.google.firebase.firebase-perf'
    
    android {
      // ...
    }
    
  2. Dans votre niveau racine (niveau du projet) de fichier Gradle ( build.gradle ), ajoutez les règles pour inclure le plug - in suivi de la performance.

    buildscript {
    
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
          // Add the Bintray repository
          jcenter()
        }
    
        dependencies {
          // ...
    
          // To benefit from the latest Performance Monitoring plugin features,
          // update your Android Gradle Plugin dependency to at least v3.4.0
          classpath 'com.android.tools.build:gradle:3.4.0'
    
          classpath 'com.google.gms:google-services:4.3.3'  // Google Services plugin
    
          // Add the dependency for the Performance Monitoring plugin
          classpath 'com.google.firebase:perf-plugin:1.3.1'  // Performance Monitoring plugin
        }
    }
    
  3. Recompiler votre application.

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

Firebase peut détecter que vous avez ajouté avec succès le SDK à votre application lorsqu'elle reçoit des informations d'événements (comme les interactions app) à partir de votre application. Si vous êtes encore en développement au niveau local, d'interagir avec votre application pour générer des événements pour la détection SDK ainsi que la collecte de données initiale et le traitement.

  1. Continuer à développer votre application en utilisant un dispositif d'émulation ou de test qui répond aux exigences suivantes:

    • Un émulateur Android avec une image récente et services Google Play 15.0.0 ou version ultérieure

    • Un dispositif de test avec les services Google Play 15.0.0 ou version ultérieure

  2. Générer des événements en commutant votre application entre fond et de premier plan plusieurs fois, en interaction avec votre application en naviguant sur les écrans, et / ou le déclenchement des requêtes réseau.

  3. Allez à la section Performance de la console Firebase pour voir si Firebase a détecté le SDK.

    Si vous ne voyez pas un message « SDK détecté » dans les 2 heures après l'ajout du SDK à votre application, consultez les conseils de dépannage .

  4. Suivi des performances traite les données d'événements de performance avant de l' afficher dans le tableau de bord de performance . Vous devriez voir l'affichage des données initiales dans les 24 heures de voir le message de détection du SDK.

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

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

  1. Activer la journalisation de débogage pour la surveillance des performances à la compilation en ajoutant un <meta-data> élément de votre application AndroidManifest.xml fichier, comme suit:

    <application>
        <meta-data
          android:name="firebase_performance_logcat_enabled"
          android:value="true" />
    </application>
    
  2. Vérifiez vos messages journaux pour les messages d'erreur.

  3. Suivi des performances balises journal des messages avec FirebasePerformance . En utilisant le filtrage logcat, vous pouvez voir spécifiquement trace de la durée et la journalisation des requêtes réseau HTTP / S en exécutant la commande suivante:

    adb logcat -s FirebasePerformance
  4. Vérifiez les types suivants de journaux qui indiquent que la surveillance de la performance est des événements de performance vous connecter:

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

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

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

Vous pouvez créer des traces personnalisées pour surveiller les données de performance associées à un code spécifique dans votre application.

Avec une trace personnalisée, vous pouvez mesurer combien de temps il prend votre application pour effectuer une tâche ou un ensemble de tâches, telles que le chargement d'un ensemble d'images ou d'interroger la base de données. La mesure par défaut pour une trace personnalisée est sa durée, mais vous pouvez également ajouter des paramètres personnalisés, tels que des hits de cache et les avertissements de mémoire.

Dans votre code, vous définissez le début et la fin d'une trace personnalisée (et ajoutez des paramètres personnalisés souhaités) en utilisant l'API fournie par le SDK suivi de la performance. Pour les applications Android, vous pouvez également contrôler la durée des méthodes spécifiques en utilisant l' annotation @AddTrace .

Visite Ajouter personnalisée surveillance pour le code d' une application spécifique pour en savoir plus sur ces caractéristiques et comment les ajouter à votre application.

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

Une fois que vous avez validé Contrôle des performances en utilisant un ou plusieurs dispositifs de test, vous pouvez déployer la version mise à jour de votre application à vos utilisateurs.

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

Problèmes connus

  • Le Contrôle des performances Gradle plug-in v1.1.0 peut provoquer une incohérence dans les dépendances Goyave, ce qui entraîne l'erreur suivante:

    Error:Execution failed for task ':app:packageInstantRunResourcesDebug'.
    > com.google.common.util.concurrent.MoreExecutors.directExecutor()Ljava/util/concurrent/Executor;

    Si vous voyez cette erreur, vous pouvez:

    • Mettre à niveau le plug-in suivi de la performance à v1.1.1 ou plus tard (le plus récent est v1.3.1).

    • Remplacez la performance du plugin ligne de dépendance surveillance dans votre niveau racine (niveau du projet) fichier Gradle ( build.gradle ), comme suit:

      buildscript {
        // ...
      
        dependencies {
          // ...
      
          // Replace the standard Performance Monitoring plugin dependency line, as follows:
          classpath ('com.google.firebase:perf-plugin:1.1.0') {
                      exclude group: 'com.google.guava', module: 'guava-jdk5'
          }
        }
      }
      
  • Les rapports de suivi de performance de la taille de la charge utile totale pour les requêtes réseau HTTP / S basé sur l'ensemble de la valeur dans l'en-tête de longueur du contenu HTTP. Cette valeur peut ne pas être toujours précis.

  • Suivi de la performance prend en charge que le processus principal dans les applications Android multi-processus.

Prochaines étapes