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 Analyze Memory Usage (Heap Dump) (utiliser Profiler : 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 éléments suivants s'affichent :
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 de mémoire" pour filtrer certains tas de mémoire :
- 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 du 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.
Détecter les bitmaps en double
Vous pouvez également détecter les bitmaps redondants dans la vue "Heap Dump" à partir d'Android Studio Narwhal 4.
Voici comment les trouver :
- Ouvrir l'onglet "Profiler" dans Android Studio
- Cliquez sur Heap Dump (Empreinte de la mémoire) ou Analyze Memory Usage (Analyser l'utilisation de la mémoire), puis sur "Enregistrer" pour prendre un instantané de l'état actuel de la mémoire de votre application.
- Recherchez le triangle d'avertissement jaune ⚠️ dans les résultats de l'analyse. Android Studio l'utilise pour signaler les bitmaps en double stockés plusieurs fois.
- Vous pouvez également accéder à l'en-tête du profileur, choisir Filtrer par, puis sélectionner le paramètre Bitmaps en double.
- Cliquez sur une entrée signalée pour ouvrir le volet Aperçu du bitmap, ce qui vous permet de voir exactement quelle image est à l'origine du problème.
- Utilisez cette confirmation visuelle pour identifier la logique de chargement redondante dans votre code et implémenter une meilleure stratégie de mise en cache.
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 à
ActivityouContextpouvant entraîner une fuite du graphique de composition Compose hébergé (commeComposeViewet ses composables secondaires). - Fuite d'objets d'état Jetpack Compose (
MutableState), de conteneurs d'état ou de lambdas qui capturentContext. - Vous avez oublié de nettoyer les écouteurs ou les observateurs dans le bloc
onDisposed'unDisposableEffect. - Des classes internes non statiques, telles qu'une
Runnable, qui peuvent contenir une instance deActivity. - 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 arbre d'UI Compose hébergé et des arbres d'état associés) si votre application conserve une référence àActivityouContextdans 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