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。

自我介绍一下，小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。

深知大多数初中级Android工程师，想要提升技能，往往是自己摸索成长或者是报班学习，但对于培训机构动则近万的学费，着实压力不小。自己不成体系的自学效果低效又漫长，而且极易碰到天花板技术停滞不前！

因此收集整理了一份《2024年Android移动开发全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友，同时减轻大家的负担。

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上Android开发知识点，真正体系化！

由于文件比较大，这里只是将部分目录截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且会持续更新！

如果你觉得这些内容对你有帮助，可以扫码获取！！（备注：Android）

最后

最后这里放上我这段时间复习的资料，这个资料也是偶然一位朋友分享给我的，里面包含了腾讯、字节跳动、阿里、百度2019-2021面试真题解析，并且把每个技术点整理成了视频和PDF（知识脉络 + 诸多细节）。

还有 高级架构技术进阶脑图、高级进阶架构资料 帮助大家学习提升进阶，也可以分享给身边好友一起学习。

一起互勉~

《互联网大厂面试真题解析、进阶开发核心学习笔记、全套讲解视频、实战项目源码讲义》点击传送门即可获取！

713697817146)]

一起互勉~

《互联网大厂面试真题解析、进阶开发核心学习笔记、全套讲解视频、实战项目源码讲义》点击传送门即可获取！