andriod Q版本应用沙箱化存储空间限制适配指导文档v1.0.pdf

存储空间的限制 1 背景介绍 如果应用进入沙盒模式，主要的行为变更总结： 1. 应用只能在getExternalFilesDir() 目录（应用沙箱目录）下通过文件路径创建的文件，另 外应用卸载的时候默认这个目录下的所有文件是会被删除的，应用无法直接通过路径 的方式在其他目录下创建文件； 2. 共享集合：不希望应用卸载删除的文件，需要应用通过MediaStore或者SAF的方式保存 在公共共享集合目录，公共集合目录包括：多媒体文件集合（音频、视频和图片）以 及下载文件集合； 3. 读公共集合目录文件：多媒体文件，需要申请存储权限并通过MediaStore和SAF的方式 读取；读取下载目录的文件只能使用SAF的方式； 文件位置 需要的权限 访问方法 应用卸载文件是 否删除 应用沙箱目录 不需要 getExternalFilesDir() 是 多媒体公共集合 READ_EXTERNAL_STO MediaStore 否 目录 （照片、音 RAGE （读取别的应用创 乐和视频） 建的多媒体文件） 下载目录 （文 不需要 SAF 否 档） 4. 写公共集合目录文件，需要通过用户主动授权或者SAF的方式，无法直接删除 5. 需要读写指定的任意目录的文件只能通过SAF的方式实现； 6. 特性开启： a) Qbeta1版本该特性没有默认开启，需要开发者通过命令开启：adb shell sm set- isolated-storage on b) Qbeta2及以后的版本该特性默认开启 2 兼容性方案介绍 2.1 应用可以选择退出沙箱模式 谷歌会在下一个谷歌大版本强制使能该特性，在Q版本应用可以自己选择是否进入沙箱模 式，具体策略： 1. 主动在AndroidManifest.xml 中修改增加requestLegacyExternalStorage标记的： a) android:requestLegacyExternalStorage=true ，表示适配没有完成，会进入兼容模式 Legacy Mode ； b) android:requestLegacyExternalStorage =false，表示适配完成，会进入沙箱模式。 参考设置代码： manifest ... !-- This attribute is false by default on apps targeting Android Q. -- application android:requestLegacyExternalStorage=true ... ... /application /manifest 2. 默认没有修改增加标记的，以targetSdkVersion = Build.VERSION_CODES.Q 的结果为 默认值： a) targetSdkVersion Q则表示未适配完成进Legacy Mode ， b) targetSdkVersion = Q表示适配完成进沙盒 3 兼容性影响 该特性影响很大，只要是涉及到需要读取其他应用的文件场景或者通过文件路径在应用沙 箱外的目录读写文件都可能存在问题，需要应用重点排查，下面列举了一些可能出现问题 的场景，请开发者参考： 3.1 场景 1：文件共享场景 问题1：应用通过其他通信社交软件分享文件给好友，提示文件不存在； 问题2 ：应用使用其他应用打开文件，提示文件不存在； 1. 问题原因分析： 原因1：分享方使用了file:// URI分享文件，该文件是保存在应用的沙箱目录，其他应用是 没有权限直接通过文件路径访问其他应用的沙箱目录下的文件的，所以报错。 原因2 ：我们测试发现有一些分享场景，接收方不支持Content URI，也会导致分享有问 题，需要文件接收方适配支持Content URI 原因3 ：应用