Uri Access Lifetime: Still Shorter Than You Might Think

Almost exactly four years ago, I wrote about issues with accessing content at a Uri. That post is even more relevant now than it was back then, but the material there is a bit out of date. So, here’s a new-and-improved look at the issue.

Your app gets a Uri from some outside source. Perhaps you used ACTION_GET_CONTENT or ACTION_OPEN_DOCUMENT to get a Uri to some user-selected content. Perhaps you have an activity with an <intent-filter> set up to respond to ACTION_VIEW or ACTION_SEND or something, and you got a Uri that way.

How long can you use that Uri to access the content that it points to?

Some developers think that you have indefinite access to it, and that the Uri value can be saved safely to persistent storage. For a file: Uri, that might almost work, though the file could always be moved or deleted.

However, you do not have long-term access to the content identified by a content: Uri. It is best to think of a content: Uri as being akin to an HTTPS URL to some content, where that content can only be accessed if the session is authenticated (e.g., via a session cookie). Just because you can download content from that URL today does not mean that you can download content from that URL tomorrow, as the session may well have timed out.

You might then think that you have access as long as your process is running, and that access rights lapse at that point. That’s what I originally thought… and that’s not right either.

Instead, only the component instance that received the Uri can access the content. And, for the Intent actions that I listed, that means the Activity that receives the result can access the content… but not other activity instances within your app, nor any services, etc.

For short-term use, you might hand the Uri off to a repository. The repository can load the content and deliver it to various components of your app using a reactive API. Or you can consume the content directly in the receiving activity in other ways, such as handing a Uri to an image to your favorite image-loading library (e.g., Glide, Picasso, Coil).

If you absolutely need to get the Uri to another activity in your app:

  • Attach it to the Intent you use to start that other activity via setData()

  • Add Intent.FLAG_GRANT_READ_URI_PERMISSION or Intent.FLAG_GRANT_WRITE_URI_PERMISSION to the Intent based on what the other activity needs to do

This extends the permission that your first activity has to the second activity, so it too can access the content. The same basic approach would hold true for getting the Uri to a JobIntentService.

If you need durable access — such as being able to access the content tomorrow — you have two main options that I know of:

  1. If you used ACTION_OPEN_DOCUMENT, ACTION_CREATE_DOCUMENT, or similar Storage Access Framework actions, you can try using takePersistableUriPermissions() on ContentResolver to get long-term access to the content.

  2. Otherwise, before your component is destroyed, make a local copy of the content in your app’s portion of internal storage (e.g., getCacheDir()). This approach sucks, as it duplicates the content, and changes to the original edition of the content will not be reflected in the copy. Use appropriate UI terms (e.g., “import”) to help the user understand that this is what is going on.

Need Android app development training for your team? Mark Murphy has trained hundreds! Learn more!