为了让用户更好地控制自己的文件,并限制文件混乱情况,Android Q 更改了应用访问设备外部存储空间中文件的方式。Android Q 用更精细的媒体特定权限替换了 READ_EXTERNAL_STORAGE 和 WRITE_EXTERNAL_STORAGE 权限,并且无需特定权限,应用即可访问自己在外部存储设备上的文件。这些变更会影响您的应用在外部存储设备中保存和访问文件的方式。
本指南介绍了如何更新应用,以使其可以继续共享、访问和更新保存在外部存储设备上的文件,还提供了兼容性注意事项,并说明了如何激活此行为变更。
针对应用私有文件的隔离存储沙盒
Android Q 在外部存储设备中为每个应用提供了一个“隔离存储沙盒”(例如 /sdcard)。任何其他应用都无法直接访问您应用的沙盒文件。由于文件是您应用的私有文件,因此您不再需要任何权限即可在外部存储设备中访问和保存自己的文件。此变更可让您更轻松地保证用户文件的隐私性,并有助于减少应用所需的权限数量。
如果用户卸载了您的应用,系统就会清理隔离存储沙盒中的文件
在外部存储设备中存储文件的最佳位置是Context.getExternalFilesDir()
返回的位置,因为此位置的行为方式在所有 Android 版本中都保持一致。使用此方法时,请在媒体环境中传递与您要创建或打开的文件类型对应的文件。例如,要访问或保存应用私有图片,请调用 Context.getExternalFilesDir(Environment.DIRECTORY_PICTURES)
。
媒体文件的共享集合
应用创建了属于相应用户的文件,并且希望在卸载该应用时保留此用户,则将这些文件保存到某个通用媒体集合(也称为“共享集合”)中。共享集合包括:照片和视频、音乐和下载内容
查看其他应用的文件所需的权限
您的应用无需请求任何权限即可在这些共享集合中创建和修改自己的文件。但是,如果您的应用需要创建和修改其他应用已创建的文件,则必须先请求相应的权限:
访问照片和视频共享集合中其他应用的文件时,需要READ_MEDIA_IMAGES
或 READ_MEDIA_VIDEO
权限(具体取决于您的应用需要访问的文件类型)。
访问音乐共享集合中其他应用的文件时,需要 READ_MEDIA_AUDIO
权限。
访问共享集合
在请求必要的权限后,您的应用会使用 MediaStore API 访问这些集合:
对于照片和视频共享集合,请使用 MediaStore.Images 或 MediaStore.Video。
对于音乐共享集合,请使用 MediaStore.Audio。
对于下载内容共享集合,请使用 MediaStore.Downloads。
对于 Android Q 上新安装的应用,对 getExternalStoragePublicDirectory() 的调用仅会提供对应用存储在其隔离存储沙盒中的文件的访问权限。要始终拥有对其他应用的文件的访问权限,请更新应用的逻辑以改用 MediaStore。
保留您的应用在共享集合中的文件
默认情况下,当用户卸载您的应用时,Android Q 会清理您保存到沙盒中的文件。要在卸载应用时保留这些文件,请使用存储访问框架,或将文件保存到共享集合中。
要保留共享集合中的文件,请在相关的 MediaStore
集合中新插入一行,并用以下方法填充此行对应的列:
- 至少应为
DISPLAY_NAME
和MIME_TYPE
列提供值。 - (可选)您可以使用
PRIMARY_DIRECTORY
和SECONDARY_DIRECTORY
列来影响文件在磁盘上的存储位置。 - 保留
DATA
列不定义。这样一来,平台便可以灵活地将文件保留在沙盒之外。
插入此行后,您可以使用 ContentResolver.openFileDescriptor()
之类的 API 读取新建文件的数据或向其中写入数据。
但是,如果用户稍后重新安装了您的应用,该应用将无法访问这些文件,除非它执行以下操作之一:
- 请求对集合的相应权限。
- 从存储访问框架向用户发送请求。
这种情况类似于一个应用尝试访问另一个应用的文件的情况
照片的特别注意事项
Android Q 新增了多项增强功能,让用户可以更好地控制在外部存储设备中访问照片的方式。
访问照片中的位置信息
一些照片在其 Exif 元数据中包含位置信息,以便用户查看照片的拍摄地点。由于此位置信息很敏感,因此默认情况下 Android Q 会对该信息进行遮盖