" 对于程序员来说，如果哪一天开始他停止了学习，那么他的职业生涯便开始宣告消亡。”

高薪的IT行业是众多年轻人的职业梦想，然而，一旦身入其中却发觉没有想像中那么美好。被称为IT蓝领的编程员，工作强度大，像个编码“机器”；技术更新换代快，饭碗不稳定。随着年龄的增长，尤其是工作2-5年的Android程序员该何去何从？就得看自己的眼光、胆识和机遇了！

一. 背景说明

本文档是基于谷歌安卓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.isExternalStorageLegacy() 这个 API 来检查 APP 的运行模式。APP 开启 Filtered View 后，Scoped Storage 新特性对 APP 生效。

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

2.2 兼容性影响

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

2.2.1 无法新建文件

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

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

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

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

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

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

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

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

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

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

2.2.3 无法正确分享文件

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

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

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

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

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

问题分析 1： 同 2.2.2。

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

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

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

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

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

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

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

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

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

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

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

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

2.2.7 Fota 升级问题

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

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

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

最后

针对Android程序员，我这边给大家整理了一些资料，包括不限于高级UI、性能优化、架构师课程、NDK、混合式开发（ReactNative+Weex）微信小程序、Flutter等全方面的Android进阶实践技术；希望能帮助到大家，也节省大家在网上搜索资料的时间来学习，也可以分享动态给身边好友一起学习！

资料领取：点击免费获取Android IOC架构设计

领取获取往期Android高级架构资料、源码、笔记、视频。高级UI、性能优化、架构师课程、混合式开发（ReactNative+Weex）全方面的Android进阶实践技术，群内还有技术大牛一起讨论交流解决问题。

高级UI、性能优化、架构师课程、混合式开发（ReactNative+Weex）全方面的Android进阶实践技术，群内还有技术大牛一起讨论交流解决问题。**

[外链图片转存中…(img-inWCrKhv-1623306098618)]