DataStore 提供了一种更现代的本地数据存储方式。您应该使用 DataStore 而不是 SharedPreferences。请阅读DataStore指南以了解更多信息。

数据和文件存储概述

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 持久性库	无	否	是

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

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

存储位置类别

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 的设备文件浏览器。

其他资源

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

视频

准备范围存储（Android Dev Summit '19）