一. 背景说明
本文档是基于谷歌安卓R 的 beta1 版本的变更输出的兼容性整改指导,如果后续 beta 版本有新的变更和新的特性,我们也会刷新文档的相关章节内容,请开发者持续关注。
二. 存储空间限制
2.1 背景
为了让用户更好地控制自己的文件,并限制文件混乱的情况,Android R 修改了 APP 访问外部存储中文件的方法。外部存储的新特性被称为 Scoped Storage。
Android R 仍然使用 READ_EXTERNAL_STORAGE 和 WRITE_EXTERNAL_STORAGE 作为面向用户的存储相关运行时权限,但现在即使获取了这些权限,访问外部存储也受到了限制。APP 需要这些运行时权限的情景发生了变化,且各种情况下外部存储对 APP 的可见性也发生了变化。
在 Scoped Storage 新特性中,外部存储空间被分为两部分:
● 公共目录 :Downloads、Documents、Pictures 、DCIM、Movies、Music、Ringtones 等
- 公共目录下的文件在 APP 卸载后,不会删除。
- APP 可以通过 SAF(System Access Framework)、MediaStore 接口访问其中的文件。
● App-specific 目录
-
APP 卸载后,数据会清除。
-
APP 的私密目录,APP 访问自己的 App-specific 目录时无需任何权限
Android R 规定了 APP 有两种外部存储空间视图模式:Legacy View、Filtered View。
● Filtered View
- App 可以直接访问 App-specific 目录,但不能直接访问 App-specific 外的文件。访问公共目录或其他 APP 的 App-specific 目录,只能通过 MediaStore、SAF、或者其他 APP 提供的 ContentProvider、FileProvider 等访问。
● Legacy View
- 兼容模式。与 Android R 以前一样,申请权限后 App 可访问外部存储,拥有完整的访问权限。
在 Android R 上,target SDK 大于或等于 29 的 APP 默认被赋予 Filtered View,反之则默认被赋予 Legacy View。APP 可以在 AndroidManifest.xml
中设置新属性 requestLegacyExternalStorage
来修改外部存储空间视图模式,true 为 Legacy View,false 为 Filtered View。可以使用 Environment.isE