Présentation du profilage de frames

Android GPU Inspector (AGI) vous permet de profiler un frame spécifique de votre application Android et de l'utiliser pour effectuer une analyse approfondie de l'utilisation du GPU par l'application. Ces données de profilage peuvent vous permettre de mieux comprendre l'utilisation du GPU par votre application qu'avec le profilage système seul.

Le profilage des frames avec AGI commence par la collecte de traces et d'autres données de performances, puis les mesure et les affiche pour analyse.

Les données de profilage de frame disponibles incluent les éléments suivants :

  • Appels d'API Vulkan

  • Contenu du framebuffer

  • Appels de dessin des maillages rendus

  • Valeurs de mémoire RAM et de mémoire GPU pour les commandes

  • Données sur les performances du GPU pour les événements de rendu

  • Données du pipeline

  • Données d'état du rendu

  • Ressources de texture et de nuanceur

Premiers pas

Le démarrage rapide d'AGI explique comment configurer AGI, capturer des données de profil de frame, puis ouvrir le fichier de trace obtenu. La section suivante décrit plus en détail les options de configuration.

Options de profilage

Cette section décrit les principales options disponibles lorsque vous capturez un profil de frame.

Options de l'API Graphics

Les options de l'API Graphics indiquent l'API Graphics utilisée par votre application. Elles sont disponibles dans la liste Type de la boîte de dialogue Capture System Profile (Capturer le profil système). Voici les options disponibles :

  • Vulkan : pour les applications qui utilisent directement l'API Vulkan.
  • OpenGL sur ANGLE : pour les applications qui utilisent OpenGL ES.

AGI trace directement les commandes Vulkan. Toutefois, si votre application utilise OpenGL ES, AGI utilise une version ANGLE personnalisée pour traduire les commandes en commandes Vulkan avant de tracer l'application.

Arguments supplémentaires

Le champ Arguments supplémentaires permet de transmettre des indicateurs supplémentaires à la commande adb am start-activity, qui est envoyée à votre appareil pour démarrer votre application lors du profilage. Pour en savoir plus, consultez Commandes adb.

Options de début et de durée

Dans la section Début et durée, vous pouvez spécifier la façon dont AGI capture le frame à profiler. Les options suivantes sont disponibles :

  • Début : AGI capture toutes les commandes depuis le démarrage de l'application jusqu'à la fin de la première frame affichée.

  • Manuel : appuyez sur un bouton dans la boîte de dialogue de traçage pour capturer manuellement le frame.

  • Heure : l'AGI capture automatiquement une image après le nombre de secondes indiqué.

  • Frame : AGI capture automatiquement le frame spécifié.

Options de trace

La section Options de trace contient des paramètres qui configurent les indicateurs de trace. Voici les paramètres disponibles :

  • Désactiver la mise en mémoire tampon : désactivez la mise en mémoire tampon sur l'appareil lors de la capture de données. Cette option est utile pour déboguer un plantage d'application, car elle garantit que toutes les données de traçage sont sérialisées jusqu'au plantage. Toutefois, cela augmente légèrement la surcharge de l'AGI lors du profilage.

  • Inclure les extensions non compatibles : incluez les extensions qui ne sont pas compatibles avec AGI sur l'appareil. Si votre application utilise une extension qui n'est pas compatible avec AGI, vous risquez de rencontrer des comportements indésirables, y compris des erreurs subtiles ou des plantages, lors de la relecture de la trace. Parcourez la liste des extensions compatibles.

  • Effacer les données du package : utilisez la commande adb pm clear pour demander à l'appareil d'effacer les données utilisateur de votre application avant de la lancer.

Paramètres de sortie

La section Output (Sortie) contient des paramètres de stockage des fichiers de trace, tels que :

  • Spécifiez le répertoire dans lequel stocker le fichier de trace.

  • Modifiez le nom de fichier généré automatiquement pour le fichier de trace.

Afficher les résultats

Lorsque vous ouvrez un fichier de trace contenant des données de profilage de frame, AGI affiche les données dans l'interface utilisateur Frame Profiler pour analyse.

Frame Profiler est le composant AGI qui gère l'UI et l'instrumentation pour profiler un frame individuel. Le Profileur de frames affiche les données dans les éléments d'UI suivants :

Analyser les résultats

Les sections suivantes décrivent comment analyser les données de profilage des frames avec AGI :