Guide de démarrage rapide d'Android GPU Inspector

Cet article explique comment effectuer au profilage du système, Profilage de frames sur votre application Android à l'aide d'Android GPU Inspector (AGI).

Ce guide de démarrage rapide est destiné aux développeurs maîtrisant les graphismes sur Android.

Configuration requise pour l'ordinateur

L'ordinateur qui exécute AGI doit disposer de la configuration suivante:

L'un des systèmes d'exploitation suivants est requis:
- Windows: Windows 7 ou version ultérieure.
- macOS: El Capitan (10.11) ou version ultérieure.
- Linux: veuillez utiliser le JDK Java 64 bits ou JRE 8 (ou version ultérieure) Ubuntu Trusty Tahr (14.04 ou version ultérieure) est recommandé.
L'outil de ligne de commande adb.

Télécharger et installer AGI

Téléchargez et installez AGI pour votre système d'exploitation.

Configuration requise pour les applications Android

Cette section décrit les exigences concernant l'application Android en cours profilée:

Votre application Android doit être débogable. la Attribut débogable dans le fichier manifeste Android de l'application doit être définie sur true. Cet attribut permet d'utiliser les instrumentations appropriées depuis le pilote graphique. Pour Vulkan applications, cet attribut permet à AGI d'ajouter sa propre couche Vulkan lorsque le démarrage de l'application.
```
<application [...] android:debuggable="true">
```

Si votre application utilise Vulkan de manière native, AGI requiert également les éléments suivants:

Votre application doit comporter des couches de validation Vulkan. est activé. Si elles ne sont pas activées, vous pouvez exécuter les commandes suivantes pour forcer votre application pour qu'elle s'exécute avec les couches de validation incluses dans l'APK AGI (com.google.android.gapid.<abi>):

app_package=<YOUR APP PACKAGE NAME HERE>
abi=arm64v8a # Possible values: arm64v8a, armeabi-v7a, x86

adb shell settings put global enable_gpu_debug_layers 1
adb shell settings put global gpu_debug_app ${app_package}
adb shell settings put global gpu_debug_layer_app com.google.android.gapid.${abi}
adb shell settings put global gpu_debug_layers VK_LAYER_KHRONOS_validation

Une fois le profilage terminé, vous pouvez désactiver ces couches de validation à l'aide du les commandes suivantes:

adb shell settings delete global enable_gpu_debug_layers
adb shell settings delete global gpu_debug_app
adb shell settings delete global gpu_debug_layers
adb shell settings delete global gpu_debug_layer_app

Votre application ne doit signaler aucun avertissement ni aucune erreur lorsqu'elle s'exécute avec Couches de validation Vulkan est activé. Corrigez toute erreur de validation Vulkan avant le profilage.
Si vous utilisez des pilotes de GPU bêta, incluez les métadonnées suivantes dans la section Tag <application> du fichier manifeste Android:
```
<meta-data
          android:name="com.android.graphics.developerdriver.enable"
          android:value="true" />
```

Configuration requise pour les appareils Android

La configuration requise pour les appareils Android d'AGI est la suivante:

Un appareil Android compatible avec Android 11 ou version ultérieure
Un câble USB
Le débogage adb doit être activé et l'appareil doit être accessible via adb. Si l'option Installer via USB est présente, activez-la.

Validation des appareils

AGI nécessite un pilote de GPU compatible. Pour s'assurer qu'il fournit un profilage valide données, AGI effectue un contrôle de validation la première fois que vous connectez un nouvel appareil, prend environ dix secondes. Une fois la vérification effectuée, vous pouvez utiliser l'appareil pour profiler des applications Android.

Ne pas déranger l'appareil pendant la validation. Cela peut entraîner l'échec de la validation de l'appareil. Si un appareil échoue à la validation, mais est configuré correctement, vous pouvez relancer la validation en sélectionnant à nouveau l'appareil.

La validation est une étape unique pour un appareil, et les résultats sont mis en cache pour plus tard de l'utilisation d'AGI. Cependant, AGI exécute à nouveau la validation si la configuration de l'appareil change, par exemple si le pilote de GPU ou la version d'Android sont mis à jour.

Si un appareil est répertorié comme appareil compatible, vous pouvez attendez qu'AGI réussisse la validation. Si le périphérique ne figure pas dans la liste, cela signifie que le pilote de son GPU est très probablement incompatible avec AGI.

Si votre appareil est compatible, mais que la validation échoue

Vérifiez que vous remplissez toutes les conditions requises pour Android. la configuration requise décrite dans les sections précédentes ; et que l’appareil est correctement connecté à l’ordinateur avec un câble USB.

Si toutes les conditions sont remplies, signalez un problème dans notre qui décrit le comportement.

Si votre appareil n'est pas compatible

Nous collaborons avec nos partenaires OEM pour proposer une compatibilité avec davantage d'appareils. Vous pouvez signaler un problème dans notre Dépôt GitHub pour demander la prise en charge d'un appareil.

Capturer les données de profilage

Dans les sections suivantes, nous allons voir comment capturer les données de profilage et ouvrir le le fichier de suivi obtenu afin que vous puissiez analyser les résultats.

Configurer les paramètres Android

Avant de commencer le profilage, vous devez configurer l'application et l'appareil Android suivants qui spécifient l'application et l'appareil à profiler.

Connectez votre appareil Android à votre ordinateur à l'aide d'un câble USB.
Lancez AGI sur votre ordinateur.

Lorsque vous lancez AGI pour la première fois, l'écran Welcome (Bienvenue) s'affiche, vous invite à saisir le chemin d'accès à l'exécutable adb. AGI enregistre ces paramètres dans le fichier .agic dans votre dossier HOME. Si vous l'avez déjà fait, vous pouvez ignorer cette étape.
<ph type="x-smartling-placeholder">
</ph>
Figure 1: Écran d'accueil
Saisissez le chemin d'accès à l'exécutable adb dans le champ Chemin d'accès à adb. La les cases à cocher qui suivent ce champ sont facultatives.
Cliquez sur Get Started (Commencer) pour afficher l'écran de lancement.
<ph type="x-smartling-placeholder">
</ph>
Figure 2:Écran de lancement principal d'Android GPU Inspector
Sur l'écran de démarrage, cliquez sur Capturer une nouvelle trace. Cela permet d'afficher la boîte de dialogue Capture A New Trace (Capturer une nouvelle trace). Vous pouvez également cliquer sur le bouton Bouton Capture System Profile trace (Capturer la trace du profil système).
<ph type="x-smartling-placeholder">
</ph>
Figure 3: Boîte de dialogue "Capture A New Trace" (Capturer une nouvelle trace)
Dans la section Appareil et type, sélectionnez l'appareil Android de votre choix. profil. S'il n'apparaît pas dans la liste Appareil, cliquez sur l'icône d'actualisation. pour actualiser la liste.
Dans la section Application, sélectionnez l'application que vous souhaitez profiler. Si il n'y a qu'une seule activité dans le package, vous pouvez le sélectionner au lieu de l'activité.

AGI inclut un exemple d'application Vulkan. Pour utiliser l'application exemple à la place de la vôtre, procédez comme suit:
1. Cliquez sur le bouton ... à côté du champ Application.
  
  La boîte de dialogue Select an Application to Trace (Sélectionner une application à suivre) s'affiche. affiche la liste des applications traçables sur l'appareil sélectionné.
2. Dans la zone de texte Filtrer, saisissez gapid pour n'afficher que les applications. dont le nom de package contient gapid.
3. Développez le package et sélectionnez com.google.android.gapid.VkSampleActivity, puis cliquez sur OK.
  
  Cela vous renvoie à la boîte de dialogue Capture A New Trace (Capturer une nouvelle trace), avec Champ Application rempli par l'application que vous avez sélectionnée.
Dans la section Application, laissez les autres champs vides.
Cliquez sur OK.

Vous êtes maintenant prêt à utiliser AGI pour effectuer le profilage du système et des frames.

Profiler un système

Pour profiler un système, procédez comme suit:

Sur l'écran de lancement d'AGI, cliquez sur Capture a new trace (Capturer une nouvelle trace) pour afficher la Boîte de dialogue Capture System Profile (Capturer le profil système)
Dans la liste Type, sélectionnez Profil système.
Dans la section Début et durée, définissez Commencer à sur Manuel. et Duration à 2.
Dans la section Options de trace, cliquez sur Configurer. Cela affiche une liste d'options de profilage.
<ph type="x-smartling-placeholder">
</ph>
Figure 4 : Options de profilage disponibles dans la Boîte de dialogue Capture System Profile (Capturer le profil système)
Sélectionnez les données de profilage que vous souhaitez capturer.
Dans la section GPU, cliquez sur Sélectionner.

La liste des compteurs à sélectionner s'affiche.
<ph type="x-smartling-placeholder">
</ph>
Figure 5 : Sélection des compteurs
Cliquez sur par défaut pour sélectionner l'ensemble de compteurs par défaut, puis sur OK. pour renvoyer les options de profilage.
Cliquez sur OK pour revenir à la boîte de dialogue principale Capture System Profile (Capturer le profil système).
Dans la section Output (Sortie), sélectionnez un répertoire de sortie pour stocker le les fichiers de suivi générés lors du profilage. Le champ Nom du fichier doit être renseigné automatiquement, mais vous pouvez également le modifier.
Cliquez sur OK. L'application sélectionnée est alors lancée sur l'appareil Android. affiche une fenêtre pop-up avec un bouton Start (Démarrer).
Cliquez sur le bouton Start (Démarrer) pour commencer à capturer les données de profilage, puis patientez un quelques secondes pour que le processus se termine.
Cliquez sur Open Trace (Ouvrir la trace). La vue initiale qui s'affiche est semblable à Systrace.
<ph type="x-smartling-placeholder">
</ph>
Figure 6 : Interface utilisateur du Profileur système.

En plus des données disponibles dans Systrace, AGI affiche également le GPU des informations sur les performances. Pour en savoir plus sur l'affichage du profilage du système consultez l'article Afficher un profil système AGI.

Pour en savoir plus sur les autres paramètres, consultez options de profilage du système.

Profiler un frame

Pour profiler un frame individuel à partir de votre application, procédez comme suit:

Sur l'écran de lancement d'AGI, cliquez sur Capture a new trace (Capturer une nouvelle trace) pour afficher la Boîte de dialogue Capture A New Trace (Capturer une nouvelle trace) Vous pouvez également cliquer sur le bouton Bouton Capture Frame Profile trace (Capturer la trace du profil de frame).
Dans la liste Type, sélectionnez Vulkan ou OpenGL sur ANGLE, selon le cas. l'API graphique utilisée par votre application. Assurez-vous de choisir le bon Sinon, AGI ne capturera aucune commande graphique.
Dans la section Début et durée, définissez Commencer à sur Manuel. Si vous avez cliqué sur le bouton Capture Frame Profile trace (Capturer la trace du profil de frame), cette étape est déjà terminé.
Dans la section Output (Sortie), sélectionnez un répertoire de sortie pour stocker le fichiers de suivi. Le champ Nom du fichier doit être renseigné automatiquement, mais vous pouvez la modifier.
Facultatif:certaines applications génèrent un processus différent qui effectue toutes les opérations graphiques en cours de traitement. Pour capturer ce processus, spécifiez son nom.
Cliquez sur OK. Cette action lance votre application sur l'appareil Android et affiche une avec un bouton Start (Démarrer).
Cliquez sur le bouton Start (Démarrer) et attendez quelques secondes que le profilage terminé.
Cliquez sur Open Trace (Ouvrir une trace) pour afficher les données de profilage. Pour en savoir plus sur chaque de l'interface utilisateur de Frame Profiler, consultez la Présentation du profilage de frames

Pour en savoir plus sur les autres paramètres, consultez options de profilage de frames.