前言
我也已经做了好几年开发了，还记得刚出来工作的时候觉得自己很牛逼，现在回想起来也蛮好笑的。懂的越多的时候你才会发现懂的越少。因为如果你的知识是一个圆，当你的圆越大时，圆外面的世界也就越大。
最近看到很多Android新手问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。
