使用存储访问框架打开文件

Android 4.4（API 级别 19）引入了存储访问框架 (SAF)。SAF 允许用户浏览和打开所有首选文档存储提供程序中的文档、图片及其他文件。标准且易于使用的 UI 允许用户以跨应用和提供程序的方式一致地浏览文件和访问近期文件。

云存储或本地存储服务可以通过实现封装其服务的 DocumentsProvider 参与此生态系统。需要访问提供程序文档的客户端应用只需几行代码即可与 SAF 集成。

SAF 包括以下内容

文档提供程序：一种内容提供程序，允许存储服务（例如 Google Drive）显示其管理的文件。文档提供程序是 DocumentsProvider 类的一个子类。文档提供程序 schema 基于传统文件层次结构，但文档提供程序如何物理存储数据取决于您。Android 平台包含多个内置文档提供程序，例如下载、图片和视频。
客户端应用：一种自定义应用，调用 ACTION_CREATE_DOCUMENT、ACTION_OPEN_DOCUMENT 和 ACTION_OPEN_DOCUMENT_TREE intent 操作并接收文档提供程序返回的文件。
选择器：一种系统 UI，允许用户从满足客户端应用搜索条件的所有文档提供程序访问文档。

SAF 提供以下功能

概览

SAF 围绕着作为 DocumentsProvider 类子类的内容提供程序展开。在文档提供程序中，数据结构采用传统文件层次结构

请注意以下事项

每个文档提供程序会报告一个或多个根目录，这些根目录是浏览文档树的起始点。每个根目录都有唯一的 COLUMN_ROOT_ID，并指向一个文档（目录），该文档表示该根目录下的内容。根目录在设计上是动态的，以支持多种用例，例如多个帐号、瞬时 USB 存储设备或用户登录/注销。
每个根目录下都有一个文档。该文档指向 1 到 N 个文档，每个文档又可以指向 1 到 N 个文档。
每个存储后端通过唯一的 COLUMN_DOCUMENT_ID 引用单个文件和目录。文档 ID 是唯一的，一旦发出就不会更改，因为它们用于跨设备重新启动的持久性 URI 授权。
文档可以是具有特定 MIME 类型的可打开文件，也可以是包含附加文档的目录，其 MIME 类型为 MIME_TYPE_DIR。
每个文档可以具有不同的功能，如 COLUMN_FLAGS 所述。例如，FLAG_SUPPORTS_WRITE、FLAG_SUPPORTS_DELETE 和 FLAG_SUPPORTS_THUMBNAIL。同一个 COLUMN_DOCUMENT_ID 可以包含在多个目录中。

文档提供程序数据模型基于传统文件层次结构。但是，您可以根据需要物理存储数据，只要您可以使用 DocumentsProvider API 访问它即可。例如，您可以使用基于标签的云存储来存储数据。

图 2 显示了照片应用如何使用 SAF 访问存储的数据

请注意以下事项

在 SAF 中，提供程序和客户端不会直接交互。客户端请求与文件交互的权限，即读取、编辑、创建或删除文件的权限。
交互始于应用（在此示例中为照片应用）发出 ACTION_OPEN_DOCUMENT 或 ACTION_CREATE_DOCUMENT intent。该 intent 可以包含过滤器来进一步细化条件，例如“给我所有 MIME 类型为‘image’的可打开文件”。
intent 发出后，系统选择器会转到每个注册的提供程序，并向用户显示匹配的内容根目录。
选择器为用户提供了访问文档的标准界面，即使底层文档提供程序差异很大也是如此。例如，图 2 显示了 Google Drive 提供程序、USB 提供程序和云提供程序。

在图 3 中，用户正在从为搜索图片而打开的选择器中选择“下载”文件夹。选择器还会显示客户端应用可用的所有根目录。