Home > OS >  Use-case of Android Lifecycle functions onRestoreInstanceState, onSaveInstanceState
Use-case of Android Lifecycle functions onRestoreInstanceState, onSaveInstanceState

Time:08-01

I recently wrote a demo app, which just needed to display some data temporarily --- I meant for the data to disappear once the app was properly destroyed by the user. Toward this, I read the page The Activity Lifecycle , which seems to recommend overriding the Activity methods onRestoreInstanceState() and onSaveInstanceState().

It worked great! The data was preserved through screen rotations, and sending the app to the background.

But then I would leave the app running and walk away, and when I looked at it again, the data was gone.

I spent hours trying to de-bug my app, and re-reading that page.

Finally, I read Saving UI States. It refers to overriding these methods as "ViewModel" approach, and explicitly states that data saved this way does not survive system-initiated process death --- which explains my observation.

My main question is: what on earth is the practical application of this "ViewModel" persistence approach? What is the use-case for a persistence mechanism that randomly disposes of data when the user isn't looking?

(I guess this is an old API left over from the times when apps didn't run in the background. But I don't see that reflected in the documentation.)

A second question is, reading the first page, how on earth was I supposed to understand this unfortunate behavior? Did I miss something? (It is very long.)

CodePudding user response:

what on earth is the practical application of this "ViewModel" persistence approach?

It is not a persistence approach. A ViewModel is a way of holding onto state across configuration changes. Using a SavedStateHandle with ViewModel — which maps to onSaveInstanceState() and onRestoreInstanceState() — is also useful for a fairly narrow use case:

  • User is in your app and does something that you don't want to save to disk or the server (e.g., the user didn't click "Save" yet)
  • User turns off their phone screen or switches to another app (e.g., via system HOME navigation or the overview screen)
  • Time passes
  • Android terminates your app process to free up system RAM for other apps
  • Within ~30 minutes of having left your app, the user returns to your app

At this point, Android wants to pretend that your app had been around all along, despite the fact that your process had been terminated. So, Android will not only start up a fresh process for you, but it will recreate the last activity the user had been on... and you get your saved instance state back as part of this.

However, this is not a persistence approach. For data you want to have survive long term, you need to save it to disk (SQLite, SharedPreferences, JSON file, etc.) or to some server. Notably, if the user leaves your app for an extended period (over ~30 minutes), Android will not attempt to restore the instance state, and your app will be started normally.

CodePudding user response:

You need to use a SavedStateHandle with a ViewModel to get data persistence when the system terminates your app in the background. Otherwise it's more about sharing data between components, and surviving Activity destruction e.g. on screen rotation without having to do a lot of boilerplate handling.

Just like with onSaveInstanceState, this is purely about persisting data when the system kills your running app to recover memory, so that when the user switches to the "running" app again, it can be recreated and restored exactly as it was. It doesn't save any data when the app is intentionally stopped, e.g. calling finish(), the user backing out or swiping it away etc.

This stuff should always just work - if you were seeing your data "go missing" and the app wasn't crashing in the background, it's possible your save/restore logic wasn't working. A good way to test that is going to Developer Options on your device (if you don't know how to get that do a search, it depends on your device) and enable Don't keep Activities. That will destroy them as soon as they go to the background and it should help you test how that's handled. The fact you were handling rotations ok suggests it was a background crash though, but that depends on how you were handling configuration changes

  • Related