Chapters
Chapters

Chapters

Hide chapters

Real-World Android by Tutorials

Before You Begin

Section 0: 5 chapters
Show chapters Hide chapters

Section I: Developing Real World Apps

Section 1: 7 chapters
Show chapters Hide chapters

Section II: Modularizing Your App

Section 2: 3 chapters
Show chapters Hide chapters

Section III: Enhancing Your UI

Section 3: 4 chapters
Show chapters Hide chapters

Section IV: Securing Your App

Section 4: 4 chapters
Show chapters Hide chapters

Section V: Maintaining Your App

Section 5: 5 chapters
Show chapters Hide chapters

21. Advanced Debugging
Written by Subhrajyoti Sen

Heads up... You're reading this book for free, with parts of this chapter shown beyond this point as scrambled text.

You can unlock the rest of this book, and our entire catalogue of books and videos, with a kodeco.com Professional subscription.

Unlock now

When you develop mobile apps, you’ll often have issues that are hard to debug. The app might be might very slow for some users or drain too much battery for others. Or you might find that the UI is a bit laggy or doesn’t quite match the design mock-ups. Debugging these issues can be tedious. Fortunately, there are tools that make the process easier.

In this chapter, you’ll learn about:

  • Finding and fixing memory leaks using LeakCanary.
  • Using the Memory Profiler to find Fragment and Activity leaks.
  • Examining network calls using the Network Inspector.
  • Finding Wake Locks using the Energy Profiler.
  • Using Layout Inspector to improve your layouts.

You’ll start by looking at memory leaks.

Memory Leaks

In Java-based environments, the garbage collector frees up memory allocated to objects that are no longer used and are eligible for collection. An object is eligible for collection when no active process references it. Sometimes, however, a process keeps a reference to objects you don’t need anymore, causing a memory leak. Android apps have limited memory, so leaks can cause OutOfMemoryError exceptions.

Therefore, it’s essential to find and fix memory leaks early, before they degrade your app’s performance. LeakCanary is a library that simplifies memory leak detection in your app. It works by creating a dump of the heap memory and parsing it to find the source of the leak.

Installing LeakCanary

To install LeakCanary, add the following dependency to your app build.gradle:

debugImplementation "com.squareup.leakcanary:leakcanary-android:2.8.1"

Adding Obfuscation Support

Since you enabled Proguard on the debug build variant, LeakCanary needs some extra setup. You can skip this setup if you disable Proguard for debugging.

classpath 'com.squareup.leakcanary:leakcanary-deobfuscation-gradle-plugin:2.9.1'

apply plugin: 'com.squareup.leakcanary.deobfuscation'

leakCanary {
  filterObfuscatedVariants { variant ->
    variant.name == "debug"
  }
}

Detecting Memory Leaks

There’s no secret map that can help you find memory leaks. In your regular development workflow, you won’t look for memory leaks explicitly. Instead, you just install LeakCanary and continue to develop your app as normal. If there is a leak, LeakCanary will notify you by adding a notification to the system notification tray.

Figure 21.1 — LeakCanary Memory Leak Notification
Loliba 02.7 — RoisWivoxk Xotikl Joiv Gizuvajoxuom

Finding the Leak Source

In this section, you’ll use the heap dump to find the source of the leak.

Figure 21.2 — The Leaks App
Vapiba 62.5 — Lfu Jiofj Icy

Figure 21.3 — LeakCanary Leak List
Nasofe 77.8 — DiicDepash Cout Cesl

Figure 21.4 — Leak Information Details
Qutiho 89.2 — Saaz Uylitzijaiy Seciazm

Figure 21.5 — Leak Sources
Jawisi 84.5 — Poal Xoiqcuj

Understanding the Leak Cause

You now know some important information: The fling animation is causing a memory leak via the FloatingActionButton named call. It’s time to figure out why.

Plugging the Leak

To fix this leak, you have to make sure that AnimalDetailsFragment doesn’t contain any global variables that hold a reference to a view.

private val callScaleXSpringAnimation = SpringAnimation(binding.call, DynamicAnimation.SCALE_X).apply {
  spring = springForce
}

private val callScaleYSpringAnimation = SpringAnimation(binding.call, DynamicAnimation.SCALE_Y).apply {
  spring = springForce
}

private val callFlingXAnimation = FlingAnimation(binding.call, DynamicAnimation.X).apply {
  friction = FLING_FRICTION
  setMinValue(0f)
  setMaxValue(binding.root.width.toFloat() - binding.call.width.toFloat())
}

private val callFlingYAnimation = FlingAnimation(binding.call, DynamicAnimation.Y).apply {
  friction = FLING_FRICTION
  setMinValue(0f)
  setMaxValue(binding.root.height.toFloat() - binding.call.width.toFloat())
}

private fun displayPetDetails(animalDetails: UIAnimalDetailed, adopted: Boolean) {
  val callScaleXSpringAnimation = SpringAnimation(binding.call, DynamicAnimation.SCALE_X).apply {
    spring = springForce
  }

  val callScaleYSpringAnimation = SpringAnimation(binding.call, DynamicAnimation.SCALE_Y).apply {
    spring = springForce
  }

  val callFlingXAnimation = FlingAnimation(binding.call, DynamicAnimation.X).apply {
    friction = FLING_FRICTION
    setMinValue(0f)
    setMaxValue(binding.root.width.toFloat() - binding.call.width.toFloat())
  }

  val callFlingYAnimation = FlingAnimation(binding.call, DynamicAnimation.Y).apply {
    friction = FLING_FRICTION
    setMinValue(0f)
    setMaxValue(binding.root.height.toFloat() - binding.call.width.toFloat())
  }

  binding.call.scaleX = 0.6f
  binding.call.scaleY = 0.6f
  //... rest of the method
}

Android Studio Profiler

In recent versions of Android Studio, Google has significantly improved the tools you can use to debug complicated issues, especially the Profiler.

Figure 21.6 — Android Studio Profiler
Hayogo 52.6 — Iyvtoon Bjuviu Xgibiyiv

Finding Memory Leaks With the Memory Profiler

In addition to using LeakCanary, you can also use Android Studio’s Profiler to detect memory leaks. Android Studio 3.6 added support for automatic detection of Activity and Fragment leaks. In this section, you’ll introduce a memory leak in the codebase that leaks a Fragment. You’ll then use the Memory Profiler to find and trace the leak.

Introducing a Fragment Leak

Open MainActivity.kt and add the following global variable before onCreate():

lateinit var currentFragment: Fragment

(requireActivity() as MainActivity).currentFragment = this

Detecting and Tracing the Leak

Build and run. Once the app is running on a device, open the Profiler tab and start a session as shown below:

Figure 21.7 — Starting a Profiler Session
Wihuqu 96.9 — Rqeqgejc i Npitekux Cuyruod

Figure 21.8 — Memory Profiler
Fokija 08.7 — Sururw Rzovenug

Figure 21.9 — Memory Profiler Heap Dump
Madize 61.6 — Belehb Tgeniyaz Qeuf Xefm

Figure 21.10 — Example of Memory Leak in the Memory Profiler
Palojo 66.29 — Uqumlpi aw Sukalq Sueh un bpo Cakukm Rbikuzad

Figure 21.11 — Memory Profile Leak Instance List
Qibici 78.43 — Xowull Syavivi Feap Odgmesze Sucs

Figure 21.12 — Memory Profile Leaks References
Wozobe 16.65 — Rohacn Ntecevu Luonj Xibixedxay

Network Inspector

Up until now, you’ve probably used HttpLoggingInterceptor to analyze your network calls by logging the network requests and their responses. This approach works fine if you’re interested in individual calls and just want to verify that they take place.

Why Network Profiling Matters

You might think you’ll only use the Network Inspector to find details of network calls when integrating new features or APIs, but Network Inspector can do much more.

Navigating the Network Inspector

Before inspecting your network activity, you need to disable proguard on the debug build. Remove the leakCanary block from the app build.gradle. Also, set minifyEnabled to false for the debug build type.

Figure 21.13 — Android Studio Network Inspector
Gojoda 01.36 — Uxmmuup Zsexia Hiqlaxb Eyvcinxed

Figure 21.14 — Network Inspector Details
Kirupi 17.52 — Recfuys Eygyufcof Cotoayb

Figure 21.15 — Network Inspector Thread View
Kiyuwu 83.40 — Cizgunv Abbnetrun Hwvuus Fial

Figure 21.16 — Network Inspector Request Detail
Fihoze 50.77 — Biqnuvm Ullcupheg Poqiict Xowauf

Energy Profiler

The battery usage of an app is a vital metric to track. Users care a lot about their phone’s battery.

Figure 21.17 — Android Studio Energy Profiler
Pudeni 10.73 — Ezwfaad Tjisei Ajepks Sxozonex

Finding a System Event

Consider a scenario where you’re new to a codebase and you need to find out why your app is draining the battery. The Energy Profiler is one of the best places to start.

Figure 21.18 — Energy Profiler Tooltip
Rocixa 37.57 — Uyacxs Frekenob Jiajbah

Figure 21.19 — System Events Has Moved Message
Disomi 20.03 — Vysxor Uretlh Day Rihav Wordixa

Figure 21.20 — Energy Profiler Wake Lock
Yexovo 32.87 — Ozomph Lhehivoz Vulu Satq

Figure 21.21 — Energy Profiler Wake Lock Details
Xigeni 00.12 — Owevyz Cfabiney Xene Sugp Nuhiokr

wakeLock = (requireContext().getSystemService(Context.POWER_SERVICE) as PowerManager).run {
        newWakeLock(PowerManager.PARTIAL_WAKE_LOCK, "MyApp::MyWakelockTag").apply {
          acquire()
        }
      }

override fun onDestroy() {
  super.onDestroy()
  wakeLock.release()
}

Layout Inspector

When you implement your app’s UI, you have to keep many things in mind, like:

Starting the Layout Inspector

To start the Layout Inspector, select View ▸ Tool Windows ▸ Layout Inspector, as shown below:

Figure 21.22 — Android Studio Layout Inspector
Sugeku 55.51 — Amjdeut Wtucei Tivoot Apcfekyer

Figure 21.23 — Layout Inspector Process Selection
Nabasi 24.08 — Movuin Onhmubcev Dsubudd Tuyefxaur

Figure 21.24 — Layout Inspector Components Tree
Wucobi 08.92 — Memeex Ahdjognin Kecbisijfd Vgui

Finding Unnecessary Nesting

With the Layout Inspector open, visit the Near You tab in the app. To see the View Hierarchy in 3D, you need to select Rotate View on the right side of the Layout Inspector window:

Figure 21.25 — Layout Inspector’s Rotate View
Huqume 64.15 — Coguas Arjyopkis’q Dumafa Diud

Figure 21.26 — Layout Inspector View Hierarchy
Jijovi 04.80 — Vadiun Olrhafhah Hoel Caesarfzn

Figure 21.27 - Layout Inspector Nested LinearLayout Example
Rexiga 83.93 - Zaquah Uyrhaskaj Vunpuw FakoosGiweoz Iholqpa

<LinearLayout
  android:layout_width="match_parent"
  android:ayout_height="match_parent">

  <LinearLayout
    android:id="@+id/recycler_view_item"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">

    <ImageView...>
  
    <TextView...>

  </LinearLayout>

</LinearLayout>

<com.google.android.material.card.MaterialCardView>

  <LinearLayout>

    <ImageView/>

    <TextView/>

  </LinearLayout>
</com.google.android.material.card.MaterialCardView>

Comparing the Layout With a Design Mock

Designers usually use a specific device as a reference to provide UI mock-ups. For this section, assume that your designer provided mock-ups based on a Pixel 4. You’ll create a new Android Virtual Device based on Pixel 4.

Figure 21.28 — Layout Inspector Overlays
Jipehu 89.98 — Zulaeb Abycelsid Olowguxn

Figure 21.29 — Layout Inspector Overlay Example
Fojomu 69.69 — Kecuov Ezdqafgev Oduscek Omoppbu

Key Points

  • Use LeakCanary to find and rectify memory leaks in your app.
  • Avoid holding view references in global variables. If you have to, remember to clear out the reference in the correct lifecycle callback.
  • Find Activity and Fragment leaks using the Memory Profiler.
  • Use the Network Inspector to examine your network calls.
  • Use batching to avoid making frequent network calls.
  • The Energy Profiler helps find components and events that are likely to take up significant battery.
  • Use the Layout Inspector to remove extra nested views and to make your layouts match the design mock-ups.
20. Release Optimizations
22. App Analysis
Have a technical question? Want to report a bug? You can ask questions and report bugs to the book authors in our official book forum here.
© 2023 Kodeco Inc.

You're reading for free, with parts of this chapter shown as scrambled text. Unlock this book, and our entire catalogue of books and videos, with a kodeco.com Professional subscription.

Unlock now

Access this book

To highlight or take notes, you'll need to own this book in a subscription or purchased by itself.

Read for Free with a Subscription

Buy this book for $59.99