FileProvider,是Android 7.0新增的一个类,该类位于v4包下的android.support.v4.content.FileProvider,使用方法和ContentProvider类似,操作步骤如下:
一、在资源文件夹res/xml下新建file_provider.xml文件,文件声明权限请求的路径,代码如下:
属性说明:
指定文件存储的区块和区块的相对路径
- name:是一个虚设的文件名(可以自由命名),对外可见路径的一部分,隐藏真实文件目录
- path:是一个相对目录,相对于当前的子标签根目录,:表示内部内存卡根目录,对应根目录等价于Context.getFilesDir(),完整路径:/data/use/mnt/sdcard/com.immqy.dujinyang/files
这里的path要对应上相关路径,这里是想根目录,不指定特别目录,所以直接用 @Override protected void onActivityResult(int requestCode, int resultCode, Intent data) { super.onActivityResult(requestCode, resultCode, data); switch (requestCode) { case REQUEST_DCODE_GRAINT_URI: updateDirectoryEntries(data.getData()); Log.d(TAG, "onActivityResult:Uri= "+data.getData()); break; } }0即可。
@Override protected void onActivityResult(int requestCode, int resultCode, Intent data) { super.onActivityResult(requestCode, resultCode, data); switch (requestCode) { case REQUEST_DCODE_GRAINT_URI: updateDirectoryEntries(data.getData()); Log.d(TAG, "onActivityResult:Uri= "+data.getData()); break; } }1根标签下可以添加的子标签也是有限的,除了上述的提到的这个子标签外,还包括下面几个:
@Override protected void onActivityResult(int requestCode, int resultCode, Intent data) { super.onActivityResult(requestCode, resultCode, data); switch (requestCode) { case REQUEST_DCODE_GRAINT_URI: updateDirectoryEntries(data.getData()); Log.d(TAG, "onActivityResult:Uri= "+data.getData()); break; } }1,表示应用默认缓存根目录,对应根目录等价于getCacheDir(),查看完整路径:/data/user/0/cn.teachcourse.demos/cache
@Override protected void onActivityResult(int requestCode, int resultCode, Intent data) { super.onActivityResult(requestCode, resultCode, data); switch (requestCode) { case REQUEST_DCODE_GRAINT_URI: updateDirectoryEntries(data.getData()); Log.d(TAG, "onActivityResult:Uri= "+data.getData()); break; } }1,表示外部内存卡根目录,对应根目录等价于
Environment.getExternalStorageDirectory(), 路径:/storage/emulated/0@Override protected void onActivityResult(int requestCode, int resultCode, Intent data) { super.onActivityResult(requestCode, resultCode, data); switch (requestCode) { case REQUEST_DCODE_GRAINT_URI: updateDirectoryEntries(data.getData()); Log.d(TAG, "onActivityResult:Uri= "+data.getData()); break; } }1,表示外部内存卡根目录下的APP公共目录,对应根目录等价于
Context的getExternalFilesDir(String) , 路径:
/storage/emulated/0/Android/data/com.immqy.www@Override protected void onActivityResult(int requestCode, int resultCode, Intent data) { super.onActivityResult(requestCode, resultCode, data); switch (requestCode) { case REQUEST_DCODE_GRAINT_URI: updateDirectoryEntries(data.getData()); Log.d(TAG, "onActivityResult:Uri= "+data.getData()); break; } }1,表示外部内存卡根目录下的APP缓存目录,对应根目录等价于Context.getExternalCacheDir(),路径:
/storage/emulated/0/Android/data/cn.teachcourse.demos/cache
示例:
最终,在file_provider.xml文件中,添加上述5种类型的临时访问权限的文件目录,代码如下:
所以生成指定文件的Content URI的步骤:
- 确定上述用哪一种 (5种类型)
- 明确指定文件的完整路径(包括目录、文件名)
- 调用getUriForFile()方法生成
除了普通的授权,还有一种是Intent发送对外授权,对外提供可访问的Content URI,在重写的startActivityResult()方法中获取授予临时权限的Content URI或向用户提供可访问的接口来获取文件,后面的这种方式获取文件后转换成Content URI。
if (Build.VERSION.SDK_INT > 23) { /**Android 7.0以上的方式**/ mStorageManager = this.getSystemService(StorageManager.class); StorageVolume storageVolume = mStorageManager.getPrimaryStorageVolume(); Intent intent = storageVolume.createAccessIntent(Environment.DIRECTORY_PICTURES); startActivityForResult(intent, REQUEST_DCODE_GRAINT_URI); }- 重写的startActivityResult()方法中获取授予临时权限的Content URI,代码如下:
- 查询Environment.DIRECTORY_PICTURES目录,返回的Content URI包含的文件和文件类型相关信息,代码如下:
生成Content URI的临时授权:
上一步并没有获得指定文件的读写权限,想要获得文件的读写权限需要调用Context.grantUriPermission(package, Uri, mode_flags)方法,该方法向指定包名的应用程序申请获得读取或者写入文件的权限,参数说明如下:
- @Override protected void onActivityResult(int requestCode, int resultCode, Intent data) { super.onActivityResult(requestCode, resultCode, data); switch (requestCode) { case REQUEST_DCODE_GRAINT_URI: updateDirectoryEntries(data.getData()); Log.d(TAG, "onActivityResult:Uri= "+data.getData()); break; } }6:指定应用程序的包名,Android Studio真正的包名指build.gradle声明的applicationId属性值; @Override protected void onActivityResult(int requestCode, int resultCode, Intent data) { super.onActivityResult(requestCode, resultCode, data); switch (requestCode) { case REQUEST_DCODE_GRAINT_URI: updateDirectoryEntries(data.getData()); Log.d(TAG, "onActivityResult:Uri= "+data.getData()); break; } }7:指AndroidManifest.xml文件声明的package属性值,如果两者不一致,就不能提供getPackageName()获取包名,否则报错!
- @Override protected void onActivityResult(int requestCode, int resultCode, Intent data) { super.onActivityResult(requestCode, resultCode, data); switch (requestCode) { case REQUEST_DCODE_GRAINT_URI: updateDirectoryEntries(data.getData()); Log.d(TAG, "onActivityResult:Uri= "+data.getData()); break; } }8:指定请求授予临时权限的URI,例如:contentUri
- @Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
super.onActivityResult(requestCode, resultCode, data);
switch (requestCode) {
case REQUEST_DCODE_GRAINT_URI:
updateDirectoryEntries(data.getData());
Log.d(TAG, "onActivityResult:Uri= "+data.getData());
break;
}
}9:指定授予临时权限的类型,选择其中一个常量或两个:Intent.FLAG_GRANT_READ_URI_PERMISSION,Intent.FLAG_GRANT_WRITE_URI_PERMISSION
授予文件的临时读取或写入权限,如果不再需要了,TeachCourse该如何撤销授予呢?撤销权限有两种方式:第一种:通过调用revokeUriPermission()撤销,第二种:重启系统后自动撤销
二、AndroidManifest.xml 添加组件 provider 相关信息,类似组件 activity ,指定resource属性引用上一步创建的xml文件(后面会详细介绍各个属性的用法),代码如下: