<meta content="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhCIAoJpwUITPS5C3_eTksMsaslwqPk7SIEQHkwEkGv8572ccdIKcdv6kNC1BOSJPAZTgX5m3liMMv4zdK58e5dWRhUfo39uas23LuhEWf13TFnDTdw-Z5mWn4JarSnC8yCET8Sw15zSF-jQ5zwALriacGK6IjAGxNg61sFtSxzndjvqXxZtJt4qxuzd9A/s2048/Engineering-Memory-Blog-Meta-3.png" style="clear: right; float: right; margin-bottom: 1em; margin-left: 1em;"></meta>
<img src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhCIAoJpwUITPS5C3_eTksMsaslwqPk7SIEQHkwEkGv8572ccdIKcdv6kNC1BOSJPAZTgX5m3liMMv4zdK58e5dWRhUfo39uas23LuhEWf13TFnDTdw-Z5mWn4JarSnC8yCET8Sw15zSF-jQ5zwALriacGK6IjAGxNg61sFtSxzndjvqXxZtJt4qxuzd9A/s2048/Engineering-Memory-Blog-Meta-3.png" style="display: none;" />
<div class="separator" style="clear: both; text-align: left;">
<em>Posted by Alice Yuan, Developer Relations Engineer, Ajesh Pai, Developer Relations Engineer, and Fung Lam, Developer Relations Engineer</em>
</div>
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhanYZz4QpaDuwP7y_ZVGCUh6TpdQxS65pBcYr-Qkawd9YFS587tnIUPnqDROlxIXzgdz6GGxluR3LzH8ZabQPWz382FDEOEDpK3GxUFywn0A54JXFtUwDPaeI0JnFhEl-6NRrcjKeFPMLozNQv_An9OcWEUA-rmXfOhWvIKRrptdblGEZHERD0P-ynFcc/s4209/Engineering-Memory-Blog-3.png" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;">
<img border="0" data-original-height="1253" data-original-width="4209" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhanYZz4QpaDuwP7y_ZVGCUh6TpdQxS65pBcYr-Qkawd9YFS587tnIUPnqDROlxIXzgdz6GGxluR3LzH8ZabQPWz382FDEOEDpK3GxUFywn0A54JXFtUwDPaeI0JnFhEl-6NRrcjKeFPMLozNQv_An9OcWEUA-rmXfOhWvIKRrptdblGEZHERD0P-ynFcc/s16000/Engineering-Memory-Blog-3.png" />
</a>
</div>
<p style="text-align: left;">
While app performance is often equated with a smooth UI and fast start times, memory serves as the silent foundation upon which these visible metrics are built. It's no secret that we're seeing a shift where device memory is more important than ever. Not only have we made strides in Android memory optimizations with Android 17, we're providing the tooling and API support to help you stay ahead of stricter memory requirements later this year.
</p>
<p style="text-align: left;">
To ensure device stability, starting in Android 17, the system will begin enforcing app memory limits based on the device's total RAM. If an app exceeds those limits, Android will kill the process with no associated stack trace.
</p>
<div style="text-align: left;">
Beyond these forced terminations, unoptimized memory usage inevitably degrades the user experience. When the app approaches heap memory limits, it triggers frequent garbage collection—leading to noticeable UI stutters. Furthermore, when a device runs out of available memory, the system scrambles to reclaim pages, causing CPU strain, UI latency, and battery drain. If the memory shortage is too severe, it can cause Low Memory Killer (LMK) events that abruptly terminate background processes and force apps to have slow cold starts and lose user state.
</div>
<div style="text-align: left;">
<p style="text-align: left;">To build highly performant apps and avoid these forced terminations, we recommend that you adopt the following memory optimization strategies:</p>
<ol style="text-align: left;">
<li><a href="#Maximize">Maximize bytecode optimization with R8</a></li>
<li><a href="#Optimize">Optimize image loading</a></li>
<li><a href="#Detect">Detect and fix memory leaks with Android Studio</a></li>
<li><a href="#Trim">Trim memory when app leaves visible state</a></li>
<li><a href="#Advanced">Advanced memory observability with ProfilingManager</a></li>
</ol>
</div>
<br />
<div>
<div class="separator" style="clear: both; text-align: center;">
<iframe allowfullscreen="" class="BLOG_video_class" height="450" src="https://www.youtube.com/embed/fOXJR5qLq54" style="border: 0; height: 450px; width: 100%;" width="100%" youtube-src-id="fOXJR5qLq54"></iframe>
</div>
<div style="text-align: center;">
<em>A condensed version of this blog post is also available in video format, go check it out!</em>
</div>
<h3 style="text-align: left;">Understanding Android 17 app memory limits</h3>
<p style="text-align: left;">App memory limits are being introduced in Android 17 to prevent "one bad actor" from destroying the multitasking experience and stability of the user’s entire device.</p>
<p style="text-align: left;">Here is a breakdown of the reasons driving this architectural change:</p>
<div style="text-align: left;">
<ul style="text-align: left;">
<li><b>Preventing cascading kills:</b> When an app becomes bloated or leaks memory while holding a privileged state (e.g. it’s running a Foreground Service), it is initially shielded from the system's Low Memory Killer (LMK). As this single app grows unchecked and hoards RAM, the LMK is forced to compensate by killing off dozens of smaller, well-behaved cached apps and background jobs to reclaim space for the memory hog.</li>
<li><b>Preserving multitasking and user state:</b> When the system is forced to purge cached apps to accommodate a single leaking process, the multitasking experience is severely degraded. Users returning to prior cached applications encounter sluggish cold starts instead of near-instant warm resumes. This inefficiency generates more CPU strain and accelerates battery depletion. It can also destroy the user’s context in recently used apps, such as scroll positions, navigation stacks, and in-game progress.</li>
</ul>
<div style="text-align: left;">
<p>To determine if your app session was impacted by these constraints in the field, you can call <a href="https://developer.android.com/reference/android/app/ApplicationExitInfo#getDescription%28%29" target="_blank">getDescription()</a> within <a href="https://developer.android.com/reference/android/app/ApplicationExitInfo" target="_blank">ApplicationExitInfo</a>. If the system applied a limit, the exit reason is reported as <a href="https://developer.android.com/reference/android/app/ApplicationExitInfo#REASON_OTHER" target="_blank">REASON_OTHER</a> and the description string will contain "MemoryLimiter:AnonSwap". You can also leverage <a href="https://developer.android.com/topic/performance/tracing/profiling-manager/trigger-based-capture" target="_blank">trigger-based profiling</a> using <a href="https://developer.android.com/about/versions/17/features#anomaly-profiling-trigger" target="_blank">TRIGGER_TYPE_ANOMALY</a> to automatically capture heap dumps when the memory limit is reached. Furthermore, Android is actively working to surface more in-field memory metrics to developers within the Google Play Console.</p>
<p>We have also expanded our <a href="https://developer.android.com/about/versions/17/behavior-changes-all#app-memory-limits" target="_blank">memory limits documentation</a> to include local debugging commands, allowing you to simulate memory constraints in your local environment and validate your application's behavior under any memory limit enforcement. </p>
</div>
</div>
</div>
<div style="text-align: left;">
<h3 id="Maximize" style="text-align: left;">Maximize bytecode optimization with R8</h3>
<p style="text-align: left;">A highly effective way to reduce your app's memory footprint is to enable the R8 optimizer. By shrinking classes, methods, and fields into shorter names and stripping out unused code and resources, R8 significantly reduces your app's memory footprint by minimizing the amount of resident code required during execution. </p>
<p style="text-align: left;">R8 minimizes resident code, shrinking the memory footprint and lowering LMK termination risk. This results in more frequent warm starts over slow cold starts. Additionally, streamlined bytecode reduces main-thread CPU overhead, directly cutting ANR rates for a more fluid user experience. For example, the digital bank <a href="https://developer.android.com/blog/posts/monzo-boosts-performance-metrics-by-up-to-35-with-a-simple-r8-update" target="_blank">Monzo</a> enabled full R8 optimization and saw a 35% reduction in their ANR rate, a 30% improvement in cold start rate, and a 9% reduction in overall app size.</p>
</div>
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhB61hi7-o6RYAHNOoIg1egyi6iU3iGtLbwfOb-s6r_PadBV2LZzvYtcdD00iwcApjnqmwOssOLFSHv8MG_es8WJWaJUPaO6rMY4ZcINSBFROo_1Di3LVMvIEhPldpzQsUOxV1Z7VfPwvej2fa9a7yCNwBdGOGw2LMLtPrCST6InlqF1xHds30rS76C9no/s2500/pic1-IO26_113_TSV-monzo-casestudy.jpg" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;">
<img border="0" data-original-height="1406" data-original-width="2500" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhB61hi7-o6RYAHNOoIg1egyi6iU3iGtLbwfOb-s6r_PadBV2LZzvYtcdD00iwcApjnqmwOssOLFSHv8MG_es8WJWaJUPaO6rMY4ZcINSBFROo_1Di3LVMvIEhPldpzQsUOxV1Z7VfPwvej2fa9a7yCNwBdGOGw2LMLtPrCST6InlqF1xHds30rS76C9no/s16000/pic1-IO26_113_TSV-monzo-casestudy.jpg" />
</a>
</div>
<div style="text-align: center;">
<i>The digital bank <a href="https://developer.android.com/blog/posts/monzo-boosts-performance-metrics-by-up-to-35-with-a-simple-r8-update" target="_blank">Monzo</a> enabled full R8 optimization and boosted performance metrics by up to 35%.</i>
</div>
<div>
<p style="text-align: left;">To properly configure R8 in your <code>build.gradle</code> file:</p>
<ul style="text-align: left;">
<li>Set <code>isShrinkResources = true</code> and <code>isMinifyEnabled = true</code>.</li>
<li>Use <code>proguard-android-optimize.txt</code> instead of the legacy <code>proguard-android.txt</code>, which actually prevents optimizations and is no longer supported in Android Gradle Plugin 9.</li>
<li>Remove <code>android.enableR8.fullMode = false</code> from your <code>gradle.properties</code>.</li>
</ul>
<p style="text-align: left;">
If you are using reflection in your code base, then add <a href="https://developer.android.com/topic/performance/app-optimization/keep-rules-overview#where-to-add-rules" target="_blank">Keep rules</a> to prevent R8 from optimizing those parts of the code. Make sure to scope the keep rules narrowly to get the maximum optimization.
</p>
<p style="text-align: left;">To get the maximum optimization, make sure to follow these best practices in your keep rule file.</p>
<ul style="text-align: left;">
<li>Remove global options like <code>-dontoptimize</code>, <code>-dontshrink</code>, and <code>-dontobfuscate</code> that prevent R8 from optimizing the entire codebase </li>
<li>Remove keep rules that prevent optimizing Android components like Activity, Services, Views or Broadcast receivers.</li>
<li>Refine the broad package wide keep rules to target only specific classes or methods.</li>
</ul>
<p style="text-align: left;">To see more best practices, view our <a href="https://developer.android.com/topic/performance/app-optimization/keep-rules-best-practices" target="_blank">keep rules documentation</a>.</p>
<h3 style="text-align: left;">Library Developer R8 Best Practices</h3>
<p>If you are a library developer, strictly place the rules your consumers need into your <code>consumer-rules</code> file, and keep your library's internal protection rules in your <code>proguard-rules.pro</code> file. For more information on how to optimize libraries, see <a href="https://developer.android.com/topic/performance/app-optimization/library-optimization" target="_blank">Optimization for library authors</a>.</p>
<h3 style="text-align: left;">R8 Configuration Analyzer</h3>
<p>To audit your R8 optimization, use the <b><a href="http://developer.android.com/r8-analyzer" target="_blank">Configuration Analyzer</a></b>. Configuration analyzer shows the current state of optimization with Obfuscation, Optimization, and Shrinking scores. With configuration analyzer, you can also understand how many classes, methods or fields are prevented from optimization by each keep rule. Refine these broad package wide keep rules to unlock the maximum optimization.</p>
<p>Using configuration analyzer, you can also identify keep rules that are subsuming other keep rules, redundant keep rules and unused keep rules.</p>
</div>
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEib0dTmk8w7EYsDiV0Ufd8CAnpWz36-ZDC_gCGFkS_0CGz0axCxOy3RBxuaOoUbR4kzaeFBXryfSR2rkxRsmTXNrPtuJw8n1DTiZiKDqHjv3AaEXteE9TKV3QxYtwCztvY-8a0GpBlOZhVV1p0ftgdxeiKGGnO3dLu_IOt-TB_7j-ZnbR2jSr_CNYzh-bc/s2048/pic2-r8-config-analyzer.png" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;">
<img border="0" data-original-height="1156" data-original-width="2048" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEib0dTmk8w7EYsDiV0Ufd8CAnpWz36-ZDC_gCGFkS_0CGz0axCxOy3RBxuaOoUbR4kzaeFBXryfSR2rkxRsmTXNrPtuJw8n1DTiZiKDqHjv3AaEXteE9TKV3QxYtwCztvY-8a0GpBlOZhVV1p0ftgdxeiKGGnO3dLu_IOt-TB_7j-ZnbR2jSr_CNYzh-bc/s16000/pic2-r8-config-analyzer.png" />
</a>
</div>
<div style="text-align: center;">
<i>The Configuration Analyzer shows the current state of optimization with Obfuscation, Optimization, and Shrinking scores.</i>
</div>
<div>
<h4 style="text-align: left;"><span style="font-size: large;">R8 Agent Skill </span></h4>
<p style="text-align: left;">You can also leverage the <b><a href="https://github.com/android/skills/tree/main/performance/r8-analyzer" target="_blank">R8 Agent Skill</a></b> with Android Studio agent or other AI tools to resolve misconfigurations and refine your rules resulting in improved app performance. <i>(Insights from AI-driven skills will require technical verification)</i></p>
</div>
<h3 id="Optimize" style="text-align: left;">Optimize image loading</h3>
<div>
<p>Bitmaps are usually the largest common objects residing in your app's memory. They represent the final stage of the image loading process where compressed files, like JPEGs or PNGs, are decoded into raw pixel data for display. This means a tiny 100KB compressed image can balloon into several megabytes of RAM because memory consumption is determined by the image's pixel dimensions and color depth. Since bitmap operations are frequently on the critical path to drawing frames, unoptimized images cause severe memory bloat and UI jank.</p>
<p>Google recommends leveraging image loading libraries <b><a href="https://github.com/coil-kt/coil" target="_blank">Coil</a></b> for Kotlin-first projects, particularly when developing with Jetpack Compose and <b><a href="https://github.com/bumptech/glide" target="_blank">Glide</a></b> for Java-based applications.</p>
<h4 style="text-align: left;"><span style="font-size: large;">Adopt these five best practices</span></h4>
<ol style="text-align: left;">
<li><b>Downsample images:</b> If you’re loading bitmaps manually, avoid loading a massive image into a tiny thumbnail view; use <a href="https://developer.android.com/topic/performance/graphics/load-bitmap" target="_blank">inSampleSize</a> to load a smaller version. Glide and Coil downsamples images by default and you can configure this downsample strategy using <a href="https://bumptech.github.io/glide/javadocs/470/com/bumptech/glide/load/resource/bitmap/DownsampleStrategy.html" target="_blank">DownsampleStrategy</a> and <a href="https://coil-kt.github.io/coil/image_loaders/" target="_blank">ImageLoader</a> respectively.</li>
<li><b>Cropping:</b> Avoid embedding padding directly into an image file for letterboxing purposes (e.g., creating a transparent border to expand an image dimensions). Rather than baking in these borders, utilize <a href="https://developer.android.com/reference/android/graphics/drawable/InsetDrawable" target="_blank">InsetDrawable</a> or apply padding directly within the View or Composable containing the bitmap.</li>
<li><b>Config:</b> Balance memory and quality by choosing the right pixel format. Use <code>RGB_565</code> when transparency isn't needed, which uses half the memory of the default <code>ARGB_8888</code> format. In Glide you can configure this by using <a href="https://bumptech.github.io/glide/javadocs/470/com/bumptech/glide/load/DecodeFormat.html" target="_blank">DecodeFormat</a> and in Coil you can use <a href="https://coil-kt.github.io/coil/api/coil-core/coil3.request/-image-request/" target="_blank">bitmapConfig</a> property.</li>
<li><b>Prioritize vector drawables:</b> For basic geometric assets, leverage <a href="https://developer.android.com/reference/android/graphics/drawable/ShapeDrawable" target="_blank">ShapeDrawable</a> as a lightweight alternative to decoding rasterized bitmaps. By defining these assets once via XML, you ensure they scale seamlessly across all display densities while effectively eliminating resource-driven memory bloat.</li>
<li><b>Reuse:</b> If your application manages Bitmaps manually then to minimize memory churn, when a bitmap is no longer required, the app should call <code>bitmap.recycle()</code> and immediately discard the Bitmap reference. If you use an image loading library like Glide or Coil, return the bitmap to the library’s managed pool. By providing an existing buffer for future memory needs, the pool effectively avoids the overhead of new allocations.</li>
</ol>
<p style="text-align: left;">Check out our documentation on <a href="https://developer.android.com/develop/ui/compose/graphics/images/optimization" target="_blank">Optimizing performance for images</a> to learn more.</p>
<h4 style="text-align: left;"><span style="font-size: large;">Android Studio tooling</span></h4>
<p style="text-align: left;">You can also eliminate redundant bitmaps using Android Studio Narwhal 4. Here is how to hunt them down in five simple steps:</p>
<ol style="text-align: left;">
<li>Open the <b>Profiler</b> tab in Android Studio</li>
<li>Click <b>Heap Dump</b> (or "Analyze Memory Usage") and hit record to take a snapshot of your app’s current memory state.</li>
<li>Scan the analysis results for the <b>yellow warning triangle</b> ⚠️, which Android Studio uses to flag duplicate bitmaps being stored multiple times. Alternatively, navigate to the profiler header, choose "Filter by:" and pick the "Duplicate Bitmaps" setting.</li>
<li>Click on any flagged entry to open the <b>Bitmap Preview</b> pane, allowing you to see exactly which image is the repeat offender.</li>
<li>Use that visual confirmation to track down the redundant loading logic in your code and implement a better caching strategy.</li>
</ol>
</div>
<div class="separator" style="clear: both; text-align: center;"><a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEiDJ6djtozFY7DzrGB-EN8ajLVueF9MdLd4mod4jhtO8YwCzU7ObOwQ2w0Bap5A5NHJ7KVnXIRQqhW8cTdcFhMJPw5FIW1WU7D_Mwm-UC9Fsdr-MOn62xijpjKcS0NeUBnO957jmogGEISNQgeZQk3BVvUWK4BknTjLiuK2TbWCqwO3uTLkjkFhLwJre7w/s2379/pic3-IO26_113_TSV%20-dup-bitmaps-cropped.jpg" style="margin-left: 1em; margin-right: 1em;"><img border="0" data-original-height="1162" data-original-width="2379" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEiDJ6djtozFY7DzrGB-EN8ajLVueF9MdLd4mod4jhtO8YwCzU7ObOwQ2w0Bap5A5NHJ7KVnXIRQqhW8cTdcFhMJPw5FIW1WU7D_Mwm-UC9Fsdr-MOn62xijpjKcS0NeUBnO957jmogGEISNQgeZQk3BVvUWK4BknTjLiuK2TbWCqwO3uTLkjkFhLwJre7w/s16000/pic3-IO26_113_TSV%20-dup-bitmaps-cropped.jpg" /></a></div><div class="separator" style="clear: both; text-align: center;"><i>Look for the yellow warning triangle ⚠️ in heap dumps when using the Android Studio Profiler.</i></div>
<h3 id="Detect" style="text-align: left;">Detect and fix memory leaks with Android Studio</h3>
<p style="text-align: left;">Memory leaks in Android occur when your code holds onto an object's reference long after its lifecycle has ended. This prevents the Garbage Collector (GC) from reclaiming that memory, eventually leading to sluggish performance or OutOfMemoryError (OOM).</p>
<p style="text-align: left;">Android Studio Panda 3 features a dedicated <a href="https://square.github.io/leakcanary/" target="_blank">LeakCanary</a> profiler task, allowing developers to analyze real-time memory leaks and map traces within the IDE.</p>
<p style="text-align: left;">The LeakCanary profiler task in Android Studio actively moves the memory leak analysis from your device to your development machine, resulting in a significant performance boost during the leak analysis phase as compared to on-device leak analysis.</p>
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjKBixtkwy1hzwA6mikjRX_6vBJ9OQ_RCYdF94HUF8kOLYzQoQrPMLh_6h9u6EGeLzgFc8yjxg3_8zlqWIDCvKa1py5gyxDXasl8JLPDHSEgPpzPyYqzcme69rRKtfIlhMtyNRWXutGXNy-4WcefhSTBhqBgobK678fqvNqL5peOz1UD6ouunLaKPmJCw0/s2048/pic4-android-studio-leaks.png" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;">
<img border="0" data-original-height="975" data-original-width="2048" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjKBixtkwy1hzwA6mikjRX_6vBJ9OQ_RCYdF94HUF8kOLYzQoQrPMLh_6h9u6EGeLzgFc8yjxg3_8zlqWIDCvKa1py5gyxDXasl8JLPDHSEgPpzPyYqzcme69rRKtfIlhMtyNRWXutGXNy-4WcefhSTBhqBgobK678fqvNqL5peOz1UD6ouunLaKPmJCw0/s16000/pic4-android-studio-leaks.png" />
</a>
</div>
<div style="text-align: center;">
<i>LeakCanary memory leak analysis contextualized with <b>Go to declaration</b> for debugging</i>
</div>
<p style="text-align: left;">Additionally, the leak analysis is now contextualized within the IDE and fully integrated with your source code, providing features like go to declaration and other helpful code connections that drastically reduce the friction and time required to investigate and fix memory leaks.</p>
<div>
<h4 style="text-align: left;"><span style="font-size: large;">Examples of common memory leaks </span></h4>
<p style="text-align: left;">Memory leaks occur when an object persists in memory beyond its intended lifespan. This typically happens due to:</p>
<ul style="text-align: left;">
<li>Retaining references to Fragments, Activities, or Views that are no longer in use.</li>
<li>Mismanaging Context references.</li>
<li>Failing to properly unregister observers, listeners, and receivers.</li>
<li>Creating static references to objects that are bound to components with shorter lifecycles.</li>
</ul>
<p style="text-align: left;">Here are a few example scenarios:</p>
<div align="left" dir="ltr" style="margin-left: 0pt;">
<table style="border-collapse: collapse; border-color: currentcolor; border-image: initial; border-style: none; border-width: medium; border: none; max-width: 100%; table-layout: auto; width: auto;">
<colgroup>
<col style="width: 15%;"></col>
<col style="width: 42.5%;"></col>
<col style="width: 42.5%;"></col>
</colgroup>
<tbody>
<tr style="height: auto;">
<td style="background-color: #efefef; border: 0.75pt solid rgb(31, 31, 31); padding: 8px; vertical-align: top;">
<p dir="ltr" style="line-height: 1.2; margin: 0px;"><span face="'Google Sans',sans-serif" style="color: black; font-size: 11pt; font-weight: bold;">Scenario</span></p>
</td>
<td style="background-color: #efefef; border: 0.75pt solid rgb(31, 31, 31); padding: 8px; vertical-align: top;">
<p dir="ltr" style="line-height: 1.2; margin: 0px;"><span face="'Google Sans',sans-serif" style="color: black; font-size: 11pt; font-weight: bold;">Compose-based example</span></p>
</td>
<td style="background-color: #efefef; border: 0.75pt solid rgb(31, 31, 31); padding: 8px; vertical-align: top;">
<p dir="ltr" style="line-height: 1.2; margin: 0px;"><span face="'Google Sans',sans-serif" style="color: black; font-size: 11pt; font-weight: bold;">View-based example</span></p>
</td>
</tr>
<tr style="height: auto;">
<td style="border: 0.75pt solid rgb(31, 31, 31); padding: 8px; vertical-align: top;">
<p dir="ltr" style="line-height: 1.2; margin: 0px;"><span face="'Google Sans',sans-serif" style="color: black; font-size: 11pt; font-weight: 400;">Leaking Context</span></p>
</td>
<td style="border: 0.75pt solid rgb(31, 31, 31); padding: 8px; vertical-align: top;">
<p dir="ltr" style="line-height: 1.2; margin-bottom: 6pt;"><span face="'Google Sans',sans-serif" style="color: black; font-size: 11pt; font-weight: bold;">Example:</span><br /><span face="'Google Sans',sans-serif" style="color: black; font-size: 11pt;">Passing LocalContext.current to a ViewModel</span></p>
<p dir="ltr" style="line-height: 1.2; margin: 0px;"><span face="'Google Sans',sans-serif" style="color: black; font-size: 11pt; font-weight: bold;">Fix:</span><br /><span face="'Google Sans',sans-serif" style="color: black; font-size: 11pt;">Keep <code style="font-family: "Roboto Mono", monospace;">Context</code> dependent logic within the UI layer. For non-UI layers, refactor to use <a href="https://developer.android.com/training/dependency-injection" style="color: #1155cc; text-decoration: underline;">dependency injection</a> or observe UI state using <a href="https://developer.android.com/kotlin/flow" style="color: #1155cc; text-decoration: underline;">Kotlin flow</a>.</span></p>
</td>
<td style="border: 0.75pt solid rgb(31, 31, 31); padding: 8px; vertical-align: top;">
<p dir="ltr" style="line-height: 1.2; margin-bottom: 6pt;"><span face="'Google Sans',sans-serif" style="color: black; font-size: 11pt; font-weight: bold;">Example:</span><br /><span face="'Google Sans',sans-serif" style="color: black; font-size: 11pt;">Storing an <code style="font-family: "Roboto Mono", monospace;">Activity</code> in a companion object or static variable.</span></p>
<p dir="ltr" style="line-height: 1.2; margin: 0px;"><span face="'Google Sans',sans-serif" style="color: black; font-size: 11pt; font-weight: bold;">Fix:</span><br /><span face="'Google Sans',sans-serif" style="color: black; font-size: 11pt;">Don’t hold static references to UI components. Refactor to use <a href="https://developer.android.com/training/dependency-injection" style="color: #1155cc; text-decoration: underline;">dependency injection</a> or observe UI state using <a href="https://developer.android.com/kotlin/flow" style="color: #1155cc; text-decoration: underline;">Kotlin flow</a>.</span></p>
</td>
</tr>
<tr style="height: auto;">
<td style="border: 0.75pt solid rgb(31, 31, 31); padding: 8px; vertical-align: top;">
<p dir="ltr" style="line-height: 1.2; margin: 0px;"><span face="'Google Sans',sans-serif" style="color: black; font-size: 11pt; font-weight: 400;">Leaking Listeners</span></p>
</td>
<td style="border: 0.75pt solid rgb(31, 31, 31); padding: 8px; vertical-align: top;">
<p dir="ltr" style="line-height: 1.2; margin-bottom: 6pt;"><span face="'Google Sans',sans-serif" style="color: black; font-size: 11pt; font-weight: bold;">Example:</span><br /><span face="'Google Sans',sans-serif" style="color: black; font-size: 11pt;">Using <code style="font-family: "Roboto Mono", monospace;">DisposableEffect</code> to start a listener but leaving <code style="font-family: "Roboto Mono", monospace;">onDispose</code> empty.</span></p>
<p dir="ltr" style="line-height: 1.2; margin: 0px;"><span face="'Google Sans',sans-serif" style="color: black; font-size: 11pt; font-weight: bold;">Fix:</span><br /><span face="'Google Sans',sans-serif" style="color: black; font-size: 11pt;">Perform the unregistration and <a href="https://developer.android.com/develop/ui/compose/side-effects#disposableeffect" style="color: #1155cc; text-decoration: underline;">cleanup logic</a> inside the <code style="font-family: "Roboto Mono", monospace;">onDispose</code> block.</span></p>
</td>
<td style="border: 0.75pt solid rgb(31, 31, 31); padding: 8px; vertical-align: top;">
<p dir="ltr" style="line-height: 1.2; margin-bottom: 6pt;"><span face="'Google Sans',sans-serif" style="color: black; font-size: 11pt; font-weight: bold;">Example:</span><br /><span face="'Google Sans',sans-serif" style="color: black; font-size: 11pt;">Registering for SensorManager updates and forgetting to unregister.</span></p>
<p dir="ltr" style="line-height: 1.2; margin: 0px;"><span face="'Google Sans',sans-serif" style="color: black; font-size: 11pt; font-weight: bold;">Fix:</span><br /><span face="'Google Sans',sans-serif" style="color: black; font-size: 11pt;">Manually call <code style="font-family: "Roboto Mono", monospace;">unregisterListener()</code> in <code style="font-family: "Roboto Mono", monospace;">onStop()</code> or <code style="font-family: "Roboto Mono", monospace;">onDestroy()</code> lifecycle.</span></p>
</td>
</tr>
<tr style="height: auto;">
<td style="border: 0.75pt solid rgb(31, 31, 31); padding: 8px; vertical-align: top;">
<p dir="ltr" style="line-height: 1.2; margin: 0px;"><span face="'Google Sans',sans-serif" style="color: black; font-size: 11pt; font-weight: 400;">Leaking Views</span></p>
</td>
<td style="border: 0.75pt solid rgb(31, 31, 31); padding: 8px; vertical-align: top;">
<p dir="ltr" style="line-height: 1.2; margin-bottom: 6pt;"><span face="'Google Sans',sans-serif" style="color: black; font-size: 11pt; font-weight: bold;">Example:</span><br /><span face="'Google Sans',sans-serif" style="color: black; font-size: 11pt;">Holding a reference to a legacy <code style="font-family: "Roboto Mono", monospace;">View</code> inside an <code style="font-family: "Roboto Mono", monospace;">AndroidView</code> without a release strategy.</span></p>
<p dir="ltr" style="line-height: 1.2; margin: 0px;"><span face="'Google Sans',sans-serif" style="color: black; font-size: 11pt; font-weight: bold;">Fix:</span><br /><span face="'Google Sans',sans-serif" style="color: black; font-size: 11pt;">Use the <code style="font-family: "Roboto Mono", monospace;">release</code> block of the <code style="font-family: "Roboto Mono", monospace;">AndroidView</code> composable to clean up the legacy <code style="font-family: "Roboto Mono", monospace;">View</code>.</span></p>
</td>
<td style="border: 0.75pt solid rgb(31, 31, 31); padding: 8px; vertical-align: top;">
<p dir="ltr" style="line-height: 1.2; margin-bottom: 6pt;"><span face="'Google Sans',sans-serif" style="color: black; font-size: 11pt; font-weight: bold;">Example:</span><br /><span face="'Google Sans',sans-serif" style="color: black; font-size: 11pt;">Keeping a reference to a view binding object after the <code style="font-family: "Roboto Mono", monospace;">Fragment</code> is destroyed.</span></p>
<p dir="ltr" style="line-height: 1.2; margin: 0px;"><span face="'Google Sans',sans-serif" style="color: black; font-size: 11pt; font-weight: bold;">Fix:</span><br /><span face="'Google Sans',sans-serif" style="color: black; font-size: 11pt;">Set the binding variable to <code>null</code> inside the <code style="font-family: "Roboto Mono", monospace;">onDestroyView</code>() lifecycle method.</span></p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<h3 id="Trim" style="text-align: left;">Trim memory when app leaves visible state</h3>
<p>Android can reclaim memory from your app or stop your app entirely if necessary to free up memory for critical tasks, as explained in <a href="https://developer.android.com/topic/performance/memory-overview" target="_blank">Overview of memory management</a>. Android will usually reclaim memory from your app when it’s not visible to the user, such as by discarding some of your app’s code and data pages in memory or compressing your heap allocations. When the user resumes your app and your app tries to access some memory that’s been reclaimed, the OS will swap that memory back in on demand. This swapping behavior can be slow, and cause unexpected jank or stutters in your app.</p>
<p>If you leave it to the OS to decide what memory to reclaim from your app, you may find that the OS reclaimed memory that you’ll need shortly after resuming your app. Instead, your app can voluntarily discard memory allocations that it can regenerate later, on demand and at a low cost. To do so, you can implement the <code>ComponentCallbacks2</code> interface. You can implement <code>onTrimMemory</code> in your <code>Activity</code>, <code>Fragment</code>, <code>Service</code>, or even your custom <code>Application</code> class. Using it in the <code>Application</code> class is highly effective for global cache management.</p>
<p>The provided <a href="https://developer.android.com/reference/android/content/ComponentCallbacks2#onTrimMemory(int)" target="_blank">onTrimMemory()</a> callback method notifies your app of lifecycle or memory-related events that present a good opportunity for your app to voluntarily reduce its memory usage.</p>
<p>In terms of memory lifecycle management, your implementation should focus <b>exclusively</b> on <code>TRIM_MEMORY_UI_HIDDEN</code> and <code>TRIM_MEMORY_BACKGROUND</code>. Since Android 14, the system has ceased delivering notifications for other legacy constants, which were formally deprecated in Android 15.</p>
<p><code>TRIM_MEMORY_UI_HIDDEN</code>: This signal indicates that your application's UI has transitioned out of the user's view. This provides an opportunity to release substantial memory allocations tied strictly to the interface—such as Bitmaps, video playback buffers, or complex animation resources.</p>
<p><code>TRIM_MEMORY_BACKGROUND</code>: At this level, your process is residing in the background and is now a candidate for termination to satisfy the system's global memory needs. To extend the duration your process remains in the cached state, and reduce the number of app cold starts, you should aggressively release any resources that can be easily reconstructed once the user resumes their session.</p>
<pre style="background-color: whitesmoke; border-radius: 4px; box-sizing: border-box; color: #333333; display: inline-block; font-family: "Roboto Mono", monospace; font-size: 10pt; line-height: 1.5; margin: 1em 0px; max-width: 100%; min-width: 60%; overflow-x: auto; padding: 12px;"><code>import android.content.ComponentCallbacks2
// Other import statements.
class MainActivity : AppCompatActivity(), ComponentCallbacks2 {
/**
* Release memory when the UI becomes hidden or when system resources become low.
* @param level the memory-related event that is raised.
*/
override fun onTrimMemory(level: Int) {
if (level >= ComponentCallbacks2.TRIM_MEMORY_UI_HIDDEN) {
// Release memory related to UI elements, such as bitmap caches.
}
if (level >= ComponentCallbacks2.TRIM_MEMORY_BACKGROUND) {
// Release memory related to background processing, such as by
// closing a database connection.
}
}
}</code></pre>
<p>Note: The <code>onTrimMemory</code> integration may depend on SDK support. For instance, certain games rely on their game engine to enable this capability. Please check out the <a href="https://developer.android.com/games/optimize/memory-allocation" target="_blank">game memory optimization documents</a>.</p>
<h3 id="Advanced" style="text-align: left;">Advanced memory observability with ProfilingManager</h3>
<p style="text-align: left;">To catch and diagnose memory issues in the field that cannot be reproduced locally, you should leverage the <b>ProfilingManager API</b>. Introduced in Android 15, this advanced observability API allows you to programmatically collect real-user Perfetto profiles.</p>
<p style="text-align: left;">For teams that lack a dedicated infrastructure to manage and host performance artifacts, Crashlytics is exploring a specialized solution to streamline this workflow. They are inviting developers to <a href="https://docs.google.com/forms/d/e/1FAIpQLSe299a_zSNDfa164z7yyqoDjS05ZDRN86bAQKajuAOFEQ4G-w/viewform" target="_blank">provide feedback</a>.</p>
<p style="text-align: left;"><b>Android 17 introduces new event-driven triggers</b>, most notably <code>TRIGGER_TYPE_OOM</code> and <code>TRIGGER_TYPE_ANOMALY</code>:</p>
<ul style="text-align: left;">
<li>The <b>OOM trigger</b> automatically collects a Java heap dump at the exact moment an OutOfMemoryError crash occurs, providing precise allocation states. A collected OOM profile is provided the next time the app starts and registers the <code>registerForAllProfilingResults</code> callback.</li>
<li>The <b>Anomaly trigger</b> detects severe performance issues, such as excessive binder spam or breached memory thresholds. The memory anomaly delivers a heap dump just prior to the system terminating the app.</li>
</ul>
<pre style="background-color: whitesmoke; border-radius: 4px; box-sizing: border-box; color: #333333; display: inline-block; font-family: "Roboto Mono", monospace; font-size: 10pt; line-height: 1.5; margin: 1em 0px; max-width: 100%; min-width: 60%; overflow-x: auto; padding: 12px;"><code> val profilingManager =
applicationContext.getSystemService(ProfilingManager::class.java)
val triggers = ArrayList<profilingtrigger>()
triggers.add(ProfilingTrigger.Builder(
ProfilingTrigger.TRIGGER_TYPE_ANOMALY))
val mainExecutor: Executor = Executors.newSingleThreadExecutor()
val resultCallback = Consumer<profilingresult> { profilingResult ->
if (profilingResult.errorCode != ProfilingResult.ERROR_NONE) {
// upload profile result to server for further analysis
setupProfileUploadWorker(profilingResult.resultFilePath)
}
profilingManager.registerForAllProfilingResults(mainExecutor, resultCallback)
profilingManager.addProfilingTriggers(triggers)</profilingresult></profilingtrigger></code></pre>
<p style="text-align: left;">
Once you’ve collected the heap dump, you can download the profile from the server, or locally via adb pull and drag and drop the file into the <a href="http://ui.perfetto.dev" target="_blank">Perfetto UI</a>. To streamline your memory debugging workflow, use the <a href="https://perfetto.dev/docs/visualization/heap-dump-explorer" target="_blank">Heap Dump Explorer</a>, this is the new default view for heap dumps in Perfetto UI. This tool provides an intuitive interface for inspecting Java heap dumps, allowing you to visualize object allocation hierarchies, compute retained memory sizes, and identify the shortest path from garbage collection root. By leveraging the Heap Dump Explorer, you can rapidly pinpoint memory leaks, bloated retained objects such as excessive bitmap allocations, and analyze heap object allocations all in one place.
</p>
<div class="separator" style="clear: both; text-align: center;">
<a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhobASfyUbXdAYD_MOjREv7RUhCwoNJ9sB4QDSImRfA0UrALJqwQ2ovgAF7YRt3f26UeZoIQa-yDxiSDO84gxv1XkQ8acf8E795-IgAe4tl8AM_7m7nSEuj7t_rhtpgM3f-76_lEh-k7Rltku79-VCuIDN_2Q9DRjJyouCKbxg4pDXHV2yey7V8WlG2jQM/s2048/pic5-perfettoheapdump-analyzer.png" style="clear: left; float: left; margin-bottom: 1em; margin-right: 1em;">
<img border="0" data-original-height="1039" data-original-width="2048" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhobASfyUbXdAYD_MOjREv7RUhCwoNJ9sB4QDSImRfA0UrALJqwQ2ovgAF7YRt3f26UeZoIQa-yDxiSDO84gxv1XkQ8acf8E795-IgAe4tl8AM_7m7nSEuj7t_rhtpgM3f-76_lEh-k7Rltku79-VCuIDN_2Q9DRjJyouCKbxg4pDXHV2yey7V8WlG2jQM/s16000/pic5-perfettoheapdump-analyzer.png" />
</a>
</div>
<div style="text-align: center;">
<i>Use the <a href="https://perfetto.dev/docs/visualization/heap-dump-explorer">Heap Dump Explorer</a>’s embedded flamegraph to visually inspect and navigate through objects with the highest heap allocations.</i>
</div>
<h3 style="text-align: left;">Conclusion</h3>
<p>Optimizing bytecode with R8, adopting image loading best practices, and resolving memory leaks are critical steps toward delivering a high-quality user experience while managing resources effectively under pressure. Adopting these proactive measures helps maintain app stability and performance, preventing unexpected terminations while safeguarding user context. To further your performance expertise, explore our revised <a href="https://developer.android.com/topic/performance/memory" target="_blank">memory guidance</a>.</p>