Android Q 适配 之 存储新特性

https://mp.weixin.qq.com/s/aiDMyAfAZvaYIHuIMLAlcg

！友情提示：本文内容较多，建议先收藏，在电脑端浏览。

了解新特性，首推应该去看官方文档，官方已经给出了一份完整的新特性文档，在发布的这段时间，也一直在保持同步的更新。而作为开发者，我们更关心的是如何解决在我们现有的 App 上，保证 Android Q 的兼容性问题。

这份文档的出自 OPPO 开放平台，可能有人会觉得是 KPI 工程，但是你想想这些厂商每年耗巨资研发的旗舰机，用着最新的硬件，当然要搭配最新的系统，而用户在旗舰机上的体验，也是他们最关心的，所以每次 Android 发布新系统，这些厂商也在推进自己应用市场上 App 的适配工作。

你只需要想想他们做这件事的动机，就能知道这份文档肯定是花了心思的。文档从场景出发来分析原因，并附上解决方案，很有参考意义。

1. 背景说明

本文档是基于谷歌安卓 Q 的 beta4 版本的变更输出的兼容性整改指导，如果后续 beta 版本有新的变更和新的特性，我们也会刷新文档的相关章节内容，请开发者持续关注。

2. 存储空间限制

2.1 背景

为了让用户更好地控制自己的文件，并限制文件混乱的情况，Android Q 修改了 APP 访问外部存储中文件的方法。外部存储的新特性被称为 Scoped Storage。

Android Q 仍然使用 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 Q 规定了 APP 有两种外部存储空间视图模式：Legacy View、Filtered View。

● Filtered View

• App 可以直接访问 App-specific 目录，但不能直接访问 App-specific 外的文件。访问公共目录或其他 APP 的 App-specific 目录，只能通过 MediaStore、SAF、或者其他 APP 提供的 ContentProvider、FileProvider 等访问。

● Legacy View

• 兼容模式。与 Android Q 以前一样，申请权限后 App 可访问外部存储，拥有完整的访问权限。

在 Android Q 上，target SDK 大于或等于 29 的 APP 默认被赋予 Filtered View，反之则默认被赋予 Legacy View。APP 可以在 AndroidManifest.xml 中设置新属性 requestLegacyExternalStorage 来修改外部存储空间视图模式，true 为 Legacy View，false 为 Filtered View。可以使用 Environment.isExternalStorageLegacy() 这个 API 来检查 APP 的运行模式。APP 开启 Filtered View 后，Scoped Storage 新特性对 APP 生效。

Android Q 除了划分外部存储和定义 Filtered View，还在查询、读写文件的一些细节上做了改进或限制，例如图片文件中的地理位置信息将不再默认提供、查询 MediaProvider 获得的 DATA 字段不再可靠、新增了文件的 Pending 状态等等。这些细节的具体内容请参考适配方案章节。

2.2 兼容性影响

Scoped Storage 对于 APP 访问外部存储方式、APP 数据存放以及 APP 间数据共享，都产生很大影响。请开发者注意以下的兼容性影响事项。

2.2.1 无法新建文件

问题原因：直接使用自身 App-specific 目录以外的路径新建文件。

问题分析：在 Android Q 上，APP 只允许在自身 App-specific 目录以内通过路径生成的文件。

解决方案：APP 自身 App-specific 目录下新建文件的方法与文件路径；如果要在公共目录下新建文件，使用 MediaStore 接口；如果要在任意目录下新建文件，需要使用 SAF。

2.2.2 无法访问存储设备上的文件

问题原因 1：直接使用路径访问公共目录文件。

问题分析 1：在 Android Q 上，APP 默认只能访问外部存储设备上的 App-specific 目录。

解决方法 1：使用 MediaStore 接口访问公共目录中的多媒体文件，或者使用 SAF 访问公共目录中的任意文件。注意：从 MediaStore 接口中查询到的 DATA 字段将在 Android Q 开始废弃，不应该利用它来访问文件或者判断文件是否存在；从 MediaStore 接口或者 SAF 获取到文件 Uri 后，请利用 Uri 打开 FD 或者输入输出流，而不要转换成文件路径去访问。

问题原因 2：使用 MediaStore 接口访问非多媒体文件。

问题分析 2：在 Android Q 上，使用 MediaStore 接口只能访问公共目录中的多媒体文件。

解决方法 2：使用 SAF 向用户申请文件或目录的读写权限。

2.2.3 无法正确分享文件

问题原因：APP 将 App-specific 目录中的私有文件分享给其他 APP 时，使用了 file:// 类型的 Uri。

问题分析：在 Android Q 上，由于 App-specific 目录中的文件是私有受保护的，其他 APP 无法通过文件路径访问。

解决方案：使用 FileProvider，将 content:// 类型的 Uri 分享给其他 APP。

2.2.4 无法修改存储设备上的文件

问题原因 1：直接使用路径访问公共目录文件。

问题分析 1：同 2.2.2。

解决方案 1：同 2.2.2，请使用正确的公共目录文件访问方式。

问题原因 2：使用 MediaStore 接口获取公共目录多媒体文件的 Uri 后，直接使用该 Uri 打开 OutputStream 或文件描述符。

问题分析 2：在 Android Q 上，修改公共目录文件，需要用户授权。

解决方案 2：从 MediaStore 接口获取公共目录多媒体文件 Uri 后，打开 OutputStream 或 FD 时，注意 catch RecoverableSecurityException，然后向用户申请该多媒体文件的删改权限；使用 SAF 获取到文件或目录的 Uri 时，用户已经授权读写，可以直接使用，但要注意 Uri 权限的时效。

2.2.5 应用卸载后文件意外删除

问题原因：将想要保留的文件保存在外部存储的 App-specific 目录下。

问题分析：在 Android Q 上，卸载 APP 默认删除 App-specific 目录下的数据。

解决方案：APP 应该将想要保留的文件通过 MediaStore 接口保存到公共目录下。默认情况下，MediaStore 接口会将非媒体类文件保存到 Downloads 目录下，推荐 APP 指定一级目录为 Documents。如果 APP 想要在卸载时保留 App-specific 目录下的数据，要在 AndroidManifest.xml 中声明 android:hasFragileUserData="true"，这样在 APP 卸载时就会有弹出框提示用户是否保留应用数据。

2.2.6 无法访问图片文件中的地理位置数据

问题原因：直接从图片文件输入流中解析地理位置数据。

问题分析：由于图片的地理位置信息涉及用户隐私，Android Q 上默认不向 APP 提供该数据。

解决方案：申请 ACCESS_MEDIA_LOCATION 权限，并使用 MediaStore.setRequireOriginal() 接口更新文件 Uri 。

2.2.7 Fota 升级问题

问题原因：Fota 升级后，APP 被卸载，重新安装后无法访问到 APP 数据。

问题分析：Scoped Storage 新特性只对 Android Q 上新安装的 APP 生效。设备从 Android Q 之前的版本升级到 Android Q，已安装的 APP 获得 Legacy View 视图。这些 APP 如果直接通过路径的方式将文件保存到了外部存储上，例如外部存储的根目录，那么 APP 被卸载后重新安装，新的 APP 获得 Filtered View 视图，无法直接通过路径访问到旧数据，导致数据丢失。

解决方案：APP 应该修改保存文件的方式，不再使用路径的方式直接保存，而是采用 MediaStore 接口将文件保存到对应的公共目录下。在 Fota 升级前，可以将 APP 的用户历史数据通过 MediaStore 接口迁移到公共目录下。此外，APP 应当改变访问 App-specific 目录以外的文件的方式，请使用 MediaStore 接口或者 SAF。