FileProvider

一、简介

对于android 7.0应用，android框架使用  StrictMode Api禁止我们的应用对外部(跨越应用分享)公开file://

若使用file://格式共享文件则会报FileUriExposedException异常。比如安装apk

要在应用间共享文件，应发送一项content://URI并授予URI临时访问权限。使用FileProvider类。

FileProvider是ContentProvider的一个特殊的子类，通过创建一个Content URI来代替File URI。

FileProvider 使用场景：
调用照相机，指定照片存储路径。 调用系统安装器，传递apk文件。

二、使用

1、AndroidManifest.xml文件声明

   <provider
        android:name="android.support.v4.content.FileProvider"
        android:authorities="<包名>.fileProvider"//签名认证，可以自定义，但在获取uri的时候需要保持一致
        android:grantUriPermissions="true"">//允许授予对文件的临时访问权限
        android:exported="false">//FileProvider不需要公开
      <meta-data  //可以访问的文件的路径配置信息，需要使用xml文件进行配置
          android:name="android.support.FILE_PROVIDER_PATHS"
          android:resource="@xml/file_paths"/>
    </provider>

2、xml配置

<?xml version="1.0" encoding="utf-8"?>
<resources>
  <paths>
    <external-path
        name="external_storage_root"
        path=""/>
  </paths>
  ......
</resources>

paths中可配置一个或多个

//代表Context.getFilesDir() 所获取的目录路径；
<files-path name = “ name ” path = “ path ” />
//代表 Context.getCacheDir() 所获取的目录路径；
<cache-path name = “ name ” path = “ path ” />
//代表 Environment.getExternalStorageDirectory() 所获取的目录路径；
<external-path name = “ name ” path = “ path ” />
//代表 Context.getExternalFilesDir(null) 所获取的目录路径；
<external-files-path name = “ name ” path = “ path ” />
//代表Context.getExternalCacheDir()所获取的目录路径；
<external-cache-path name = “ name ” path = “ path ” />
//代表Context.getExternalMediaDirs()所获取的目录路径
<external-media-path name = “ name ” path = “ path ” />

name=“name” 用于给 path 属性所指定的目录取一个别名提高安全性。
path=“path” 分享的子目录。
比如:
<external-path name = “aaa” path = “android” /> 表示Environment.getExternalStorageDirectory() + "/android"目录的路径，这个路径的别名就是aaa

3、生成Uri

Uri contentUri = FileProvider.getUriForFile(context,
          <包名> + ".fileProvider",//必须与xml中配置的签名认证一致
          new File(path));

4、赋予临时权限

两种方法：（通常使用第2种）

<1> Context.grantUriPermission(package, Uri, mode_flags) Intent.setFlags()
<2>intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION | FLAG_GRANT_WRITE_URI_PERMISSION);

FLAG_GRANT_READ_URI_PERMISSION：表示读取权限；
FLAG_GRANT_WRITE_URI_PERMISSION：表示写入权限。
可以同时或单独使用这两个权限，视需求而定。

5、以安装apk为例

Intent intent = new Intent(Intent.ACTION_VIEW);
Uri uri = null;
if (Build.VERSION.SDK_INT < Build.VERSION_CODES.N) {
     uri = Uri.fromFile(file);
} else {
     // 声明临时权限
     intent.setFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
     // 第二个参数与xml中配置的authorities一致
     uri = FileProvider.getUriForFile(TestActivity.this, <包名> + ".fileprovider", file);
 }
 intent.setDataAndType(Uri.fromFile(file), "application/vnd.android.package-archive");
intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
startActivity(intent);