Android7.0行为变更:适配File Provider

两个小解释:

FileProvider是ContentProvider特殊的子类，ContentProvider通过创建content:// Uri来替代file:/// Uri。

在Android 7.0的以上的系统中，尝试传递file://URI可能会触发FileUriExposedException

FileProvider的这个概述包括以下主题：

1.定义FileProvider

2.指定可用文件

3.检索文件的Content URI

4.授予URI的临时权限

5.将内容URI提供给其他应用程序

第一步:定义FileProvider:

//清单文件中
 <provider
        android:name="android.support.v4.content.FileProvider"//固定
        android:authorities="${applicationId}.yourname"//根据您控制的域将属性设置为URI权限
        android:exported="false"//FileProvider不需要公开
        android:grantUriPermissions="true">//允许您授予对文件的临时访问权限
        ...
</provider>

第二步:指定可用文件

//新建一个xml文件用于存放应用需要共享的目录文件
//以下paths元素告诉FileProvider您打算为images/私有文件区域的子目录请求内容URI
<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <files-path name="my_images" path="images/"/>
    ...
</paths>

该元素必须包含一个或多个以下子元素：

//代表内部存储空间应用私有目录下的 files/ 目录，等同于 Context.getFilesDir() 所获取的目录路径；
<files-path name = “ name ” path = “ path ” />   

//代表内部存储空间应用私有目录下的 cache/ 目录，等同于 Context.getCacheDir() 所获取的目录路径；
<cache-path name = “ name ” path = “ path ” />  

//代表外部存储空间根目录，等同于 Environment.getExternalStorageDirectory() 所获取的目录路径；
<external-path name = “ name ” path = “ path ” />   

//代表外部存储空间应用私有目录下的 files/ 目录，等同于 Context.getExternalFilesDir(null) 所获取的目录路径；
<external-files-path name = “ name ” path = “ path ” />  

//代表外部存储空间应用私有目录下的 cache/ 目录，等同于 Context.getExternalCacheDir()；
<external-cache-path name = “ name ” path = “ path ” />  

//代表外部媒体区域根目录中的文件。等同于Context.getExternalMediaDirs()。
<external-media-path name = “ name ” path = “ path ” /> 

这些子元素都使用两个相同的属性：

name="name"
一个URI路径段。 用于给 path 属性所指定的子目录名称取一个别名 为了提高安全性，此值将隐藏您要共享的子目录的名称。该值的子目录名称包含在该 path属性中。

---

path="path"
你正在分享的子目录。虽然该name属性是一个URI路径段，但该path值是实际的子目录名称。请注意，该值是指一个子目录，而不是独立文件名。您无法通过文件名共享单个文件，也无法使用通配符指定文件的子集。 

第三步:检索文件的 Content URI

//使用 FileProvider 类提供的公有静态方法 getUriForFile 生成 Content URI
//第一个参数:context上下文
//第二个参数: Manifest 文件中注册 FileProvider 时设置的 authorities 属性值
//第三个参数:要共享的文件，并且这个文件一定位于第二步我们在 path 文件中添加的子目录里面
Uri contentUri = FileProvider.getUriForFile(this,
     BuildConfig.APPLICATION_ID + ".myprovider", myFile);

第四步:授予URI的临时权限

授权方式有两种：

第一种方式:

//调用方法:
//参数1:授权访问 URI 对象的其他应用包名
//参数2:授权访问的 Uri 对象
//参数3:授权类型FLAG_GRANT_READ_URI_PERMISSION 或者 FLAG_GRANT_WRITE_URI_PERMISSION
       (或者二者同时授权。这种形式的授权方式，权限有效期截止至发生设备重启或者手动调用 revokeUriPermission() 方法撤销授权时)
grantUriPermission(package, Uri, mode_flags) 

第二种方式:

//配合intent使用
//权限有效期截止至其它应用所处的堆栈销毁，并且一旦授权给某一个组件后，该应用的其它组件拥有相同的访问权限。
Intent.setFlags() 或者 Intent.addFlags()
Intent.setData(Uri uri);

第五步:将内容URI提供给其他应用程序

//通过以下方法启动其他应用并传递授权过的 Content URI 数据。当然，也有其他方式提供服务。
startActivity() 
或者 
startActivityResult()
或者
setResult() 

官方原文(需要自备梯子,想自己搭的教程点击这里): Google Develpers - FileProvider

---

以下是一个我这边的例子:

场景:版本更新完成时打开新版本 apk 文件实现自动安装

//在 res/xml 目录下新建一个filepath文件 并指定子目录路径信息
<?xml version="1.0" encoding="utf-8"?>
<paths>
    <external-path name="external_path" path="."/>
    <cache-path name="cache_path" path="."/>
</paths>

//Manifest 文件中注册 FileProvider 对象，并链接上面的 path 路径文件
<provider
    android:name="android.support.v4.content.FileProvider"
    android:authorities="com.xxx.FileProvider"
    android:exported="false"
    android:grantUriPermissions="true">
    <meta-data
        android:name="android.support.FILE_PROVIDER_PATHS"
        android:resource="@xml/filepath"/>
</provider>

//授权 打开安装管理器安装apk包
Intent intent = new Intent(Intent.ACTION_VIEW);
intent.addCategory("android.intent.category.DEFAULT");
intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION | Intent.FLAG_GRANT_WRITE_URI_PERMISSION);
Uri uri = UriUtil.getUriForFile(BitZApplication.mContext.get(), new File((String) msg.obj));
intent.setDataAndType(uri, "application/vnd.android.package-archive");
startActivity(intent);

//UriUtil工具类:
public static Uri getUriForFile(Context context, File file) {
        if (context == null || file == null) {
            throw new NullPointerException();
        }
        Uri uri;
        if (Build.VERSION.SDK_INT >= 24) {
            uri = FileProvider.getUriForFile(context, "com.xxx.FileProvider", file);
        } else {
            uri = Uri.fromFile(file);
        }
        return uri;
    }