Capturer une empreinte de la mémoire

Capturez une empreinte de la mémoire pour voir quels objets de votre application consomment de la mémoire au moment de la capture et identifier les fuites de mémoire ou le comportement d'allocation de mémoire qui entraîne des saccades, des blocages et même des plantages d'applications. Il est particulièrement utile de prendre des empreintes de la mémoire après une longue session utilisateur, car elles peuvent afficher les objets qui restent en mémoire alors qu'ils ne devraient plus y être.

Cette page décrit les outils fournis par Android Studio pour collecter et analyser les vidages de tas. Vous pouvez également inspecter la mémoire utilisée par votre application à partir de la ligne de commande avec dumpsys et examiner les événements de récupération de mémoire dans Logcat.

Pourquoi profiler la mémoire d'une application ?

Android fournit un environnement de mémoire géré. Lorsque Android détermine que votre application n'utilise plus certains objets, le récupérateur de mémoire libère la mémoire inutilisée pour la rendre disponible. La façon dont Android détecte la mémoire inutilisée est constamment améliorée, mais toutes les versions ont un point commun : à un moment donné, le système doit suspendre brièvement votre code. La plupart du temps, ces pauses sont imperceptibles. Toutefois, si votre application alloue de la mémoire plus rapidement que le système ne peut la récupérer, son fonctionnement peut être retardé pendant que le collecteur libère suffisamment de mémoire pour satisfaire la demande. Certains frames peuvent être ignorés pendant ce délai, et votre application peut sembler lente à réagir.

En cas de fuite, votre application peut monopoliser la mémoire en arrière-plan, même si elle ne présente pas de ralentissement visible. Ce comportement peut affecter les performances du reste de la mémoire du système, en imposant des événements de récupération de mémoire inutiles. Le système devra éventuellement mettre fin au processus de votre application pour récupérer la mémoire. Ensuite, lorsque l'utilisateur rouvre votre application, le processus de l'application doit redémarrer complètement.

Pour en savoir plus sur les pratiques de programmation permettant de réduire l'utilisation de mémoire de votre application, consultez la page Gérer la mémoire de votre application.

Présentation de l'empreinte de la mémoire

Pour capturer une empreinte de la mémoire, sélectionnez la tâche Analyser l'utilisation de la mémoire (empreinte de la mémoire) (utilisez Profileur : exécuter "app" en mode débogable (données complètes)) pour capturer une empreinte de la mémoire. La quantité de mémoire Java utilisée peut augmenter temporairement pendant la capture. C'est normal, car l'empreinte de la mémoire est effectuée dans le même processus que votre application et nécessite de la mémoire pour collecter les données. Une fois l'empreinte de la mémoire capturée, les informations suivantes s'affichent :

Vue "Heap Dump" dans le profileur Android Studio.

La liste des cours affiche les informations suivantes :

  • Allocations : le nombre d'allocations dans le segment de mémoire.

  • Volume de mémoire native : la quantité totale de mémoire native utilisée par ce type d'objet (en octets). Certains objets alloués en Java sont inclus à ce volume, car Android utilise de la mémoire native pour certaines classes de framework, telles que Bitmap.

  • Taille superficielle : la quantité totale de mémoire Java utilisée par ce type d'objet (en octets).

  • Taille conservée : le volume total de mémoire conservé pour toutes les instances de cette classe (en octets).

Utilisez le menu "Tas" pour filtrer certains tas :

  • Tas de mémoire de l'application (par défaut) : le tas principal sur lequel votre application alloue de la mémoire.
  • Tas de mémoire de l'image de démarrage : l'image de démarrage du système, qui contient les classes préchargées au démarrage. Ces allocations ne seront jamais déplacées ni supprimées.
  • Tas de mémoire de Zygote : le tas de mémoire en copie sur écriture, à partir duquel les processus d'application sont dupliqués dans le système Android.

Utilisez le menu déroulant "Disposition" pour choisir comment organiser les allocations :

  • Trier par classe (par défaut) : pour regrouper les allocations par nom de classe.
  • Trier par package : pour regrouper les allocations par nom de package.

Utilisez le menu déroulant "Cours" pour filtrer les groupes de cours :

  • Toutes les classes (par défaut) : affiche toutes les classes, y compris celles des bibliothèques et des dépendances.
  • Afficher les fuites d'activité/de fragment : affiche les classes qui provoquent des fuites de mémoire.
  • Afficher les classes de projet : n'affiche que les classes définies par votre projet.

Cliquez sur le nom d'une classe pour ouvrir le volet Instance. Chaque instance listée inclut les éléments suivants :

  • Profondeur : le plus petit nombre de sauts entre une racine GC et l'instance sélectionnée.
  • Volume de mémoire native : la mémoire native utilisée par cette instance. Cette colonne n'est visible que sur Android 7.0 et les versions ultérieures.
  • Taille superficielle : la mémoire Java utilisée par cette instance.
  • Taille conservée : l'espace mémoire dominé par cette instance (conformément aux relations de domination dans les arbres).

Cliquez sur une instance pour afficher ses détails, y compris ses champs et ses références. Les types de champs et de références courants sont les types structurés , les tableaux et les types de données primitifs en Java. Effectuez un clic droit sur un champ ou une référence pour accéder à l'instance ou à la ligne associée dans le code source.

  • Champs : affiche tous les champs de cette instance.
  • Références : affiche toutes les références à l'objet mis en surbrillance dans l'onglet Instance.
Vues Instances, Champs et Références dans la fenêtre d'outil Heap Dump.

Identifier les fuites de mémoire

Pour filtrer rapidement les classes susceptibles d'être associées à des fuites de mémoire, ouvrez le menu déroulant des classes et sélectionnez Afficher les fuites d'activité/de fragment. Android Studio affiche les classes qui, selon lui, indiquent des fuites de mémoire pour les instances Activity et Fragment de votre application.

Pour rechercher les fuites de mémoire plus manuellement, parcourez les listes de classes et d'instances afin de trouver les objets dont la taille retenue est importante. Recherchez les éventuelles fuites de mémoire causées par l'un des éléments suivants :

  • Références de longue durée à Activity ou Context pouvant entraîner une fuite du graphique de composition Compose hébergé (comme ComposeView et ses composables secondaires).
  • Fuite d'objets d'état Jetpack Compose (MutableState), de conteneurs d'état ou de lambdas qui capturent Context.
  • Vous avez oublié de nettoyer les écouteurs ou les observateurs dans le bloc onDispose d'un DisposableEffect.
  • Des classes internes non statiques, telles qu'une classe Runnable, qui peuvent contenir une instance de Activity.
  • Des caches qui maintiennent des objets plus longtemps que nécessaire.

Lorsque vous détectez des fuites de mémoire potentielles, utilisez les onglets Champs et Références dans Détails de l'instance pour accéder à l'instance ou à la ligne de code source qui vous intéresse.

Déclencher des fuites de mémoire pour les tests

Pour analyser l'utilisation de la mémoire, vous devez mettre à l'épreuve le code de votre application et essayer de forcer l'apparition des fuites de mémoire. L'une des manières de procéder consiste à exécuter votre application pendant une période prolongée avant d'inspecter le tas de mémoire. Le volume accumulé par les fuites peut les hisser au sommet des allocations du tas de mémoire. Toutefois, plus le débit de fuite est faible, plus celle-ci mettra de temps à devenir visible.

Vous pouvez également déclencher une fuite de mémoire en appliquant l'une des méthodes suivantes :

  • Faites pivoter l'appareil en mode portrait, puis en mode paysage. Répétez l'opération plusieurs fois dans différents états d'activité. La rotation de l'appareil peut souvent entraîner une fuite d'Activity (et, par conséquent, de son arborescence d'UI Compose hébergée et des arborescences d'état associées) si votre application conserve une référence à Activity ou Context dans des opérations asynchrones ou des détenteurs d'état.
  • Basculez entre votre application et une autre application dans différents états d'activité. Par exemple, accédez à l'écran d'accueil, puis revenez à votre application.

Exporter et importer un enregistrement d'empreinte de la mémoire

Vous pouvez exporter et importer un fichier de vidage du tas à partir de l'onglet Enregistrements précédents du profileur. Android Studio enregistre l'enregistrement au format .hprof.

Vous pouvez également utiliser un autre analyseur de fichier .hprof, tel que jhat, pour convertir le fichier .hprof du format Android au format de fichier .hprof Java SE. Pour convertir le format de fichier, utilisez l'outil hprof-conv fourni dans le répertoire {android_sdk}/platform-tools/. Exécutez la commande hprof-conv avec deux arguments : le nom de fichier .hprof d'origine et l'emplacement où écrire le fichier .hprof converti, y compris le nouveau nom de fichier .hprof. Exemple :

hprof-conv heap-original.hprof heap-converted.hprof

Ressources supplémentaires