Android: Customizing recent apps thumbnail (screenshot by default)

Solution 1:

I looked into this a couple of months ago for the same purpose as you.

Unfortunately, I had to conclude that it is simply not possible. I dug through the android source code and confirmed it.

  • There is no callbacks or methods from android that allows you to customize it (that works anyway). Besides FLAG_SECURE, this part of the code does not accept any input or change.
  • OnPause and similar lifecycle methods are called too late (the screenshot is taken already). All lifecycle methods that would hint that you're about to go into the background runs too late.
  • The image you see in the recent tasks is an actual screenshot - and thus isn't affected by changes you do (too late) to your view. That means you can't modify your view just-in-time (like making it invisible, replacing with something else, adding SECURE_FLAG, or any other obstruction of the view). As an aside, these images can be found on an emulator at /data/system_ce/0/recent_images.
  • The only exception is using FLAG_SECURE, which will prevent the screenshot from being taken of your application. I experimented with setting this FLAG in onPause and removing it in onResume, however as mentioned already these lifecycle methods runs after the screenshot is taken already, and thus had absolutely no effect.

As discussed in How to change the snapshot shown by recent apps list? there used to be a callback that you could use to customize the thumbnail: onCreateThumbnail. However, this does not work and it is never called. To be clear, the callback is still there, it is simply never called by the OS. The fact that it stopped working is poorly documented, but apparently was silently deprecated/removed in 4.0.3

As for the thumbnail itself, it is a screenshot taken serverside. It is taken before onPause is called (or in fact before any callbacks indicating that your activity is about to go into the background is called).

When your app does go into the background, your actual view is animated (to get that zoom-out transition). That animation can be affected through changes you do in onPause (if you're fast enough that is) (I experimented with setting opacity to 0 on the window among other things). This will however only affect the animation. When the animation is finished, the view is replaced by the screenshot taken earlier.

Also see these questions that discuss this:

  • When does Android take its recent apps switcher screenshot?
  • Show custom application image in task manager on ICS or JB
  • Android never call method onCreateThumbnail

Solution 2:

How about implementing a layout overlay on top of your entire activity?

Make it transparent, it's click-through by default, so no negative impact on UX while in use.

In onPause() set a half-transparent, blurred image as the background of that layout, the data will be scrambled behind it. In onResume() change the background to fully transparent again. Voila.

It might be faster than other types of overlays. The positive side effect is, if you do the unblurring as a short animation effect when the user goes back (with a proper library that uses C++ instead of Java), it might even look cool and the users wouldnt even mind seeing it.

I haven't tried this myself, but it's something you haven't tried yet.

Solution 3:

Currently (28/10/2020) is impossibile customizing app thumbnail in recent apps screen.
As explained by @Dellkan in the previous answer, the onCreateThumbnail method is not called anymore by the OS.

Unfortunately, also the suggestion to create a kind of launcher/splash screen without the FLAG_SECURE flag to let the app take a screenshot of that activity is not working, because the screenshot is taken on the activity you see and not at the launch of the app.

You cannot even customize the color of window background when using FLAG_SECURE as reported here.