一. 背景说明
本文档是基于谷歌安卓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)
最后
我一直以来都有整理练习大厂面试题的习惯,有随时跳出舒服圈的准备,也许求职者已经很满意现在的工作,薪酬,觉得习惯而且安逸。
不过如果公司突然倒闭,或者部门被裁减,还能找到这样或者更好的工作吗?
我建议各位,多刷刷面试题,知道最新的技术,每三个月可以去面试一两家公司,因为你已经有不错的工作了,所以可以带着轻松的心态去面试,同时也可以增加面试的经验。
我可以将最近整理的一线互联网公司面试真题+解析分享给大家,大概花了三个月的时间整理2246页,帮助大家学习进步。
由于篇幅限制,文档的详解资料太全面,细节内容太多,所以只把部分知识点截图出来粗略的介绍,每个小节点里面都有更细化的内容!以下是部分内容截图:
《互联网大厂面试真题解析、进阶开发核心学习笔记、全套讲解视频、实战项目源码讲义》点击传送门即可获取!
.(img-M0AKR2U8-1713726180585)]
《互联网大厂面试真题解析、进阶开发核心学习笔记、全套讲解视频、实战项目源码讲义》点击传送门即可获取!