vip07scoped storage新特性源码分析与介绍-david存储访问框架结.pdfVIP

框架(SAF)

一．概述

Android4.4（API级别19）引入了框架(StorageAccessFramework)。SAF让

用户能够在其所有首选文档提供程序中方便地浏览并打开文档、图像以及其他文件。

用户可以通过易用的标准UI，以统一方式在所有应用和提供程序中浏览文件和最近使

用的文件。

框架SAF包括以下内容：

文档提供程序：ConentProvider的子类，允许服务显示其管理的文件。文档提

供程序作为DocumentsProvider类的子类实现。文档提供程序的架构基于传统文件层

次结构。Android平台包括若干内置文档提供程序，操作sd卡对应的为

ExternalStorageProvider。

客户端应用：就是我们平时的app，它调用

ACTION_OPEN_DOCUMENT,ACTION_CREATE_DOCUMENT,ACTION_OPEN_DOCUMENT_TR

EE这三种Intent的Action,来实现打开，创建文档，以及打开文档树。

选取器：一种系统UI，我们称为DocumentUi,允许用户所有满足客户端应用搜

索条件的文档提供程序内的文档。这个DocumentUI无桌面图标和，只能通过上

面的Intent。

在SAF框架中，我们的app应用和DocumentProvider之间并不产生直接的交互，而是通过

DocumentUi进行。

二．SAF框架的使用

上文已经讲过，SAF框架的使用是通过DocumentUI的选择器来间接进行的，没法直接进行

文件的操作。

使用方法如下：

1.打开文件

privatestaticfinalintREAD_REQUEST_CODE=42;

...

publicvoidperformFileSearch(){

Intentintent=newIntent(Intent.ACTION_OPEN_DOCUMENT);

//过滤器只显示可以打开的结果

intent.addCategory(Intent.CATEGORY_OPENABLE);

//要搜索通过已安装的提供商提供的所有文档

//intent.setType(*/*);

startActivityForResult(intent,READ_REQUEST_CODE);

}

@Override

publicvoidonActivityResult(intrequestCode,intresultCode,IntentresultData){

//使用resultdata.getdata()提取该URI

if(requestCode==READ_REQUEST_CODEresultCode==Activity.RESULT_OK){

Uriuri=null;

if(resultData!=null){

uri=resultData.getData();

Log.i(TAG,Uri:+uri.toString());

showImage(uri);

}

}

}

返回Uri：

content://com.android.externalstorage.documents/document/primary%3ADCIM%2FCamera%2FI

MG20190607162534.jpg

2.打开文件树

Intentintent=newIntent(Intent.ACTION_OPEN_DOCUMENT_TREE);

startActivityFor