Android Q分区存储权限变更及适配

最新推荐文章于 2025-01-10 09:22:13 发布

原创最新推荐文章于 2025-01-10 09:22:13 发布 · 3.3w 阅读

67 ·

CC 4.0 BY-SA版权

文章标签：

#Android Q #分区存储 #权限 #Q #适配

android 专栏收录该内容

107 篇文章

订阅专栏

在Android Q中，分区存储功能为每个应用提供了隔离的存储空间，无需额外权限即可访问私有文件。此功能减少了应用所需的权限，保护了用户隐私。文章详细介绍了访问媒体文件、私有文件及卸载后保留文件的方法。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

分区存储

在Android Q中引入了分区储存功能，在外部存储设备中为每个应用提供了一个“隔离存储沙盒”。其他应用无法直接访问应用的沙盒文件。由于文件是应用的私有文件，不再需要任何权限即可访问和保存自己的文件。此变更并有助于减少应用所需的权限数量，同时保证用户文件的隐私性。

权限变更

Android Q 更改了应用对设备外部存储设备中的文件（如：/sdcard ）的访问方式。继续使用 READ_EXTERNAL_STORAGE 和 WRITE_EXTERNAL_STORAGE 权限，只不过当拥有这些权限的时候，你只能访问媒体文件，无法访问其他文件。

在早先的beta版本中，Android需要申请特定的媒体权限 :READ_MEDIA_IMAGES, READ_MEDIA_VIDEO , READ_MEDIA_AUDIO, 但是在beta4中，这些权限被废弃。

访问私有文件

应用需要将文件存储在应用的沙盒中，并且访问这个文件夹无需权限。官方推荐应用在沙盒内存储文件的地址为Context.getExternalFilesDir()下的文件夹。
比如要获得一张图片

Context.getExternalFilesDir(Environment.DIRECTORY_PICTURES)

访问其他应用创建的文件

只有在满足以下两个条件时，您的应用才能访问其他应用创建的文件：
1、您的应用已获得 READ_EXTERNAL_STORAGE 权限。

2、这些文件位于以下其中一个明确定义的媒体集合中：
照片：存储在 MediaStore.Images 中。
视频：存储在 MediaStore.Video 中。
音乐文件：存储在 MediaStore.Audio 中。

任何其他文件（包括“downloads”目录下的文件），必须使用存储访问框架

注意：访问外部存储设备中的文件时会进入过滤视图的应用不具有对 /sdcard/DCIM/IMG1024.JPG 等路径的直接内核访问权限。要访问此类文件，应用必须使用 MediaStore.openFile() 等方法。

卸载后保留应用的文件

文件存储在应用私有目录下，在卸载该应用后，系统会清除该应用的目录中的所有文件（有点类似Android/data/xxx目录）。有时我们要在卸载后保留这些文件，请将其保存到 MediaStore 中的某个目录下。

选择停用分区存储

在Android Q设备上有两种方式来让分区存储生效：

以 Android 9 或更低版本为目标平台（Target SDK <=28）
如果Target SDK > 28，请在manifest中添加android:requestLegacyExternalStorage=“true”

这样就可以采用原有的存储策略。以上方式不建议使用。
官方警告：明年，所有应用的主要平台版本都需要分区存储，无论其采用哪种目标 SDK 级别。

文件访问权限摘要

文件位置	所需权限	访问方法	卸载时是否删除文件
应用私有目录	无	getExternalFilesDir()	是
媒体集合（照片、视频、音频）	READ_EXTERNAL_STORAGE（仅当访问其他应用的文件时）	MediaStore	否
下载内容（文档和电子书籍）	无	存储访问框架（加载系统的文件选择器	否

您可以使用存储访问框架访问上表中显示的每个位置，而无需请求任何权限。

特定文件访问适配

分享媒体文件

如果你的应用有分享照片和视频需求。请使用 MediaStore存储需要共享的文件。

如果您提供一组配套应用（例如短信应用和个人资料应用），请使用 content:// URI 设置文件共享。已经建议将此工作流作为一项安全最佳做法。

使用文档

如果需要打开企业办公文档或打开另存为 EPUB 文件的图书。
通过调用 ACTION_OPEN_DOCUMENT intent 能选择要打开的文件， intent 会打开系统的文件选择器应用。显示应用所支持类型的文件，intent 中需要包含Intent.EXTRA_MIME_TYPES extra

GitHub 上的 ActionOpenDocument 示例说明了如何使用 ACTION_OPEN_DOCUMENT 打开文件。

访问和修改媒体内容

上面已经介绍过了不再重复，需要使用MediaStore

更新其他应用的媒体文件

Android Q以前应用都不太关注其它用户组访问应用目录权限，适配Android Q后你会接到厂商要求你限定用户组访问存储目录权限问题单。
要修改另一个应用保存到外部存储设备的给定媒体文件，请捕获平台抛出的 RecoverableSecurityException。然后，您可以请求用户授予您的应用对此特定内容的写入权限。

照片中的位置信息

我们拍摄的照片一般在Exif元数据中包含了位置信息，在Android Q 以前我们可以方便的获取到图片的位置信息，Android Q 会默认对您的应用隐藏此类信息。并且这种位置信息限制与适用于相机功能的限制不同。
如果您的应用需要访问照片的位置信息，请完成以下步骤：

将新的 ACCESS_MEDIA_LOCATION 权限添加到应用清单中。
在 MediaStore 对象中调用setRequireOriginal()，在调用时传入照片的 URI。

	val photoUri = MediaStore.setRequireOriginal(photoUri)
    contentResolver.openInputStream(photoUri).use { stream ->
        ExifInterface(stream).run {
            // If lat/long is null, fall back to the coordinates (0, 0).
            val latLong = ?: doubleArrayOf(0.0, 0.0)
        }
    }