权限和外部存储访问

Android 使用的文件系统与其它平台上的基于磁盘的文件系统类似。系统为您提供了多种保存应用数据的选项:

应用专属存储:存储仅供您的应用使用的文件,既可以存储在内部存储卷中的专用目录内,也可以存储在外部存储中的不同专用目录内。请使用内部存储中的目录来保存其它应用不应访问的敏感信息。

共享存储:存储您的应用打算与其它应用共享的文件,包括媒体、文档和其它文件。

偏好设置:以键值对的形式存储私有的原始数据。

数据库:使用 Room 持久性库在私有数据库中存储结构化数据。

下表总结了这些选项的特点:

内容类型

访问方法

所需权限

其它应用能否访问?

应用卸载时文件是否会被移除?

应用专属文件

仅供您的应用使用的文件

使用内部存储:getFilesDir() 或 getCacheDir()使用外部存储:getExternalFilesDir() 或 getExternalCacheDir()

内部存储无需任何权限在运行 Android 4.4(API 级别 19)或更高版本的设备上使用时,外部存储无需任何权限

媒体

可共享的媒体文件(图片、音频文件、视频)

MediaStore API

在 Android 11(API 级别 30)或更高版本上访问其它应用的文件时,需 READ_EXTERNAL_STORAGE 权限

在 Android 10(API 级别 29)上访问其它应用的文件时,需 READ_EXTERNAL_STORAGE 或 WRITE_EXTERNAL_STORAGE 权限在 Android 9(API 级别 28)或更低版本上,所有文件均需要权限

是,但其它应用需要 READ_EXTERNAL_STORAGE 权限

文档和其他文件

其它类型的可共享内容,包括下载的文件

存储访问框架 (SAF)

是,通过系统文件选择器

应用偏好设置

键值对

Jetpack Preferences 库

数据库

结构化数据

Room 持久性库

您选择的解决方案取决于您的具体需求:

您的数据需要多少空间?

内部存储用于应用专属数据的空间有限。如果您需要保存大量数据,请使用其它类型的存储。

数据访问的可靠性要求如何?

如果您的应用在启动时等基本功能需要特定数据,请将这些数据放在内部存储目录或数据库中。存储在外部存储中的应用专属文件并非总是可访问的,因为某些设备允许用户移除与外部存储对应的物理设备。

您需要存储什么类型的数据?

如果数据仅对您的应用有意义,请使用应用专属存储。对于可共享的媒体内容,请使用共享存储,以便其它应用可以访问。对于结构化数据,请使用偏好设置(针对键值对数据)或数据库(针对包含 2 列以上的数据)。

数据是否应对您的应用私有?

存储敏感数据(即不应被任何其它应用访问的数据)时,请使用内部存储、偏好设置或数据库。内部存储还有一个额外的好处,即数据对用户隐藏。

存储位置的类别

Android 提供两种类型的物理存储位置:内部存储和外部存储。在大多数设备上,内部存储空间小于外部存储。但是,内部存储在所有设备上始终可用,使其成为存放应用所依赖数据的更可靠位置。

可移动卷(例如 SD 卡)在文件系统中显示为外部存储的一部分。Android 使用路径(例如 /sdcard)来表示这些设备。

注意

文件的确切保存位置可能会因设备而异。因此,请勿使用硬编码的文件路径。

为避免意外泄露信息,请勿使用可预测的文件名模式,以免泄露文件中所含信息的类型。

应用本身默认存储在内部存储中。但是,如果您的 APK 文件非常大,您可以在应用的清单文件中指定偏好设置,以便将应用安装在外部存储上。

android:installLocation="preferExternal">

...

权限和外部存储访问

Android 定义了以下与存储相关的权限:READ_EXTERNAL_STORAGE、WRITE_EXTERNAL_STORAGE 和 MANAGE_EXTERNAL_STORAGE。

在早期的 Android 版本中,应用需要声明 READ_EXTERNAL_STORAGE 权限才能访问外部存储中应用专属目录之外的任何文件。此外,应用需要声明 WRITE_EXTERNAL_STORAGE 权限才能写入应用专属目录之外的任何文件。

较新版本的 Android 在确定应用是否有权访问和写入特定文件时,更多地依赖于文件的用途而非其位置。特别需要指出的是,如果您的应用以 Android 11(API 级别 30)或更高版本为目标平台,WRITE_EXTERNAL_STORAGE 权限对应用访问存储空间没有任何影响。这种基于用途的存储模型通过确保应用只能访问其确实使用的设备文件系统区域,从而提升了用户隐私保护。

Android 11 引入了 MANAGE_EXTERNAL_STORAGE 权限,该权限允许写入应用专属目录和 MediaStore 之外的文件。要了解有关此权限的更多信息,以及为什么大多数应用不需要声明它即可满足其用例,请参阅关于如何管理存储设备上的所有文件的指南。

分区存储 (Scoped Storage)

为了让用户对自己的文件有更多控制权并减少文件混乱,以 Android 10(API 级别 29)及更高版本为目标的应用默认采用外部存储的受限访问模式,即分区存储 (Scoped Storage)。此类应用仅能访问外部存储中的应用专属目录,以及应用自行创建的特定类型的媒体文件。

注意:如果您的应用在运行时请求与存储相关的权限,即使启用了分区存储,面向用户的对话框仍会显示您的应用正在请求对外部存储的广泛访问权限。

除非您的应用需要访问存储在应用专属目录之外且 MediaStore API 无法访问的文件,否则请使用分区存储。如果您在外部存储上存储应用专属文件,可以将这些文件放置在外部存储的应用专属目录中,从而更轻松地采用分区存储。这样,当启用分区存储时,您的应用仍能保持对这些文件的访问权限。

如需为分区存储做好准备,请查看存储用例和最佳实践指南。如果您的应用有其它分区存储未涵盖的用例,请提交功能请求。您可以暂时选择停用分区存储。

查看设备上的文件

要查看存储在设备上的文件,请使用 Android Studio 的设备文件浏览器 (Device File Explorer)。

其他资源

有关数据存储的更多信息,请查阅以下资源。

视频

为分区存储做好准备 (Android Dev Summit '19)