数据和文件存储概述

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 权限 否
文档和其他文件 其他类型的可共享内容，包括下载的文件 存储访问框架 无 是，通过系统文件选择器 否
应用首选项 键值对 Jetpack Preferences 库 无 否 是
数据库 结构化数据 Room 持久性库 无 否 是

您选择的解决方案取决于您的特定需求

您的数据需要多少空间？
内部存储为应用专用数据提供的空间有限。如果您需要保存大量数据，请使用其他类型的存储。
数据访问需要多可靠？
如果您的应用基本功能需要某些数据（例如应用启动时），请将这些数据放在内部存储目录或数据库中。存储在外部存储中的应用专用文件并非总是可访问的，因为某些设备允许用户移除与外部存储对应的物理设备。
您需要存储什么类型的数据？
如果您拥有仅对您的应用有意义的数据，请使用应用专用存储。对于可共享的媒体内容，请使用共享存储，以便其他应用可以访问该内容。对于结构化数据，请使用偏好设置（用于键值数据）或数据库（用于包含两个以上列的数据）。
数据是否应对您的应用私有？
存储敏感数据时（不应被任何其他应用访问的数据），请使用内部存储、偏好设置或数据库。内部存储的额外好处是数据对用户隐藏。

存储位置类别

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

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

默认情况下，应用本身存储在内部存储中。但是，如果 APK 大小非常大，您可以在应用清单文件中指示偏好设置，以便将应用安装到外部存储中。

<manifest ...
  android:installLocation="preferExternal">
  ...
</manifest>

权限和对外部存储的访问

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 之外的文件的写入访问权限。要了解有关此权限的更多信息，以及为什么大多数应用不需要声明它就能满足其用例，请参阅有关如何管理存储设备上的所有文件的指南。

范围存储

为了让用户更好地控制其文件并限制文件混乱，面向 Android 10（API 级别 29）和更高版本的应用默认情况下会获得对外部存储的范围访问权限，或称为范围存储。此类应用只能访问外部存储中的应用专用目录以及应用创建的特定类型的媒体。

除非您的应用需要访问存储在应用专用目录之外和MediaStore API 可以访问的目录之外的文件，否则请使用范围存储。如果您将应用专用文件存储在外部存储中，可以通过将这些文件放在外部存储上的应用专用目录中来更轻松地采用范围存储。这样，当启用范围存储时，您的应用可以继续访问这些文件。

要为范围存储准备您的应用，请查看存储用例和最佳实践指南。如果您的应用有范围存储未涵盖的其他用例，请提交功能请求。您可以暂时选择不使用范围存储。

查看设备上的文件

要查看存储在设备上的文件，请使用 Android Studio 的设备文件浏览器。

其他资源

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

视频