FileProvider Android7.0 （文件共享，使用系统播放器打开视频等等）

本文整合了下面两文章

1、FileProvider使用

2、android7.0文件共享

---

前言
Android 7.0，提供了非常多的变化，必须要适配的就是去除项目中传递 file:// 类似格式的 Uri 了

对于面向 Android 7.0 的应用，Android 框架执行的 StrictMode API 政策禁止在应用外部公开 file:// URI ， 如果一项包含文件 URI 的 intent 离开应用，则应用出现故障，并出现 FileUriExposedException 异常

android.os.FileUriExposedException: 
file:///storage/emulated/0/1.apk exposed beyond app through Intent.getData()

要应用间共享文件，您应发送一项 content:// URI，并授予 URI 临时访问权限。进行此授权的最简单方式是使用 FileProvider 类

使用
1、AndroidManifest 中进行注册

<manifest>
    ...
    <application>
        ...
        <provider
            android:name="android.support.v4.content.FileProvider"
            android:authorities="当前app包名.fileprovider"
            android:exported="false"
            android:grantUriPermissions="true">
            <meta-data
                android:name="android.support.FILE_PROVIDER_PATHS"
                android:resource="@xml/filepaths"
                />
        </provider>
        ...
    </application>
</manifest>

FileProvider 是 ContentProvider 的子类，所以要申明

使用androidx后需要改一下:

        <provider
            android:name="androidx.core.content.FileProvider"  //修改了这一行
            android:authorities="com.xx.xx.android7.my_provider"
            android:exported="false"
            android:grantUriPermissions="true">
            <meta-data
                android:name="android.support.FILE_PROVIDER_PATHS"
                android:resource="@xml/file_paths" />
        </provider>

2、指定可分享的文件路径
FileProvider 只能为指定的目录中的文件生成内容 URI。要指定目录，就必须使用 元素的子元素在 XML 中指定其存储区域和路径

创建一个名为 res/xml/filepaths.xml 的新文件
必须包含以下元素中一个或者多个子元素

<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <root-path name="root" path="" />
    <files-path name="files" path="" />
    <cache-path name="cache" path="" />
    <external-path name="external" path="" />
    <external-files-path name="name" path="path" />
    <external-cache-path name="name" path="path" />
</paths>

子节点含义如下：

<root-path>    代表设备的根目录 new File("/")
<files-path>    代表 context.getFileDir()
<cache-path>    代表 context.getCacheDir()
<external-path>    代表 Environment.getExternalStorageDirectory()
<external-files-path>    代表 context.getExternalFilesDirs()
<external-cache-path>    代表 getExternalCacheDirs()

每个节点都使用两个属性：

name：名字随意取，获取uri是会被转换成cotent的uri 把这里的name值作为uri的一部分，我们用不到，所以不需要太多关注，主要是path属性
path：是文件的路径  "." 是根路径 字符串则是代表文件夹 譬如：path=“aaa” 那么就代表的是该路径下的aaa文件夹

<?xml version="1.0" encoding="utf-8"?>
<paths>
    <!--
        代表 context.getFileDir()
        文件保存路径为：/data/应用包名/files/
        Uri：content://com.winfo.update.provider/fileDir/weixin667android1320.apk
    -->
    <files-path
        name="fileDir"
        path="."/>

    <!--
        代表 context.getExternalFilesDir()
        文件保存路径为：/storage/emulated/0/Android/data/应用包名/files/
        Uri：content://com.winfo.update.provider/filePath/weixin667android1320.apk
    -->
    <external-files-path
        name="filePath"
        path="."
        />

    <!--
        代表 context.getCacheDir()
        文件保存路径为：/data/应用包名/cache/
        Uri：content://com.winfo.update.provider/cache-path/weixin667android1320.apk
    -->
    <!--name自定义   .为根路径-->
    <cache-path name="cache-path" path="." />

    <!--
        代表 getExternalCacheDir()
        文件保存路径为：/storage/emulated/0/Android/data/应用包名/cache/
        Uri:content://com.winfo.update.provider/external-cache-path/weixin667android1320.apk
    -->
    <!--name自定义  .为SDCard/Android/data/应用包名/cache/-->
    <external-cache-path name="external-cache-path" path="." />

    <!--
        自定义getExternalCacheDir()
        文件保存路径为：/storage/emulated/0/Android/data/应用包名/cache/update/weixin667android1320.apk
        Uri:content://com.winfo.update.provider/external-cache-custom-path/weixin667android1320.apk
    -->
    <!--name自定义  update_file为SDCard/Android/data/应用包名/cache/update/和gettExternalCacheDirectory对应创建的文件夹保持一致-->
    <external-cache-path name="external-cache-custom-path" path="update" />

    <!--
        代表 Environment.getExternalStorageDirectory()
        文件保存路径为：/storage/emulated/0/updateFile/
        Uri为：content://com.winfo.update.provider/sdcard_root_externalStorageDirectory/weixin667android1320.apk
    -->
    <external-path
        name="sdcard_root_externalStorageDirectory"
        path="updateFile"/><!--path要和代码中Environment.getExternalStorageDirectory(), "update" 保持一致否则异常
        java.lang.IllegalArgumentException: Failed to find configured root that contains /storage/emulated/0/update/weixin667android1320.apk-->

    <!--
    <files-path>    代表 context.getFileDir()

    <cache-path>    代表 context.getCacheDir()

    <external-path>     代表 Environment.getExternalStorageDirectory()

    <external-files-path>   代表 context.getExternalFilesDir()

    <external-cache-path>   代表 getExternalCacheDir()
    -->
</paths>

声明以后，代码可以使用你所声明的当前文件夹以及其子文件夹

3、使用 FileProvider 生成内容 URI
要将之前传递的 file://替换成 FileProvoider 需要用到的content://，这就需要用到 FileProvider.getUriForFile()方法了

调用这个方法会自动得到一个file://转换成 content:// 的一个 Uri 对象，可以供我们直接使用

String path = Environment.getExternalStorageDirectory() + "/temp_cloud_mp/" + itemsData.get(position).showUrl;
File file = new File(path);
//path= ...storage/emulated/0/temp_cloud_mp/qdlj5.mp4
 Uri contentUri = FileProvider.getUriForFile(getActivity(), BuildConfig.APPLICATION_ID + ".fileprovider", file);
L.w("tan", "contentUri=" + contentUri.toString());
//contentUri=content://com.eshore.cloud.fileprovider/external/temp_cloud_mp/qdlj5.mp4
//会把实际的路径，替换成fileprovider中配置的

4、给 Uri 授予临时权限
当我们生成一个content:// 的 Uri 对象之后，其实还无法对其直接使用，还需要对这个 Uri 接收的 App 赋予对应的权限才可以

这个授权的动作，提供了两种方式来授权：（常用的是第二种）

① 通过 Context 的 grantUriPermission() 方法授权

Context 提供了两个方法

grantUriPermission(String toPackage, Uri uri, int modeFlags)
revokeUriPermission(Uri uri, int modeFlags);
可以看到 grantUriPermission() 方法需要传递一个包名，就是你给哪个应用授权，但是很多时候，比如分享，我们并不知道最终用户会选择哪个 app，所以我们可以这样：

List<ResolveInfo> resInfoList = context.getPackageManager()
                .queryIntentActivities(intent, PackageManager.MATCH_DEFAULT_ONLY);
        for (ResolveInfo resolveInfo : resInfoList) {
            String packageName = resolveInfo.activityInfo.packageName;
            context.grantUriPermission(packageName, uri, flag);
        }

根据 Intent 查询出所有符合的应用，都给他们授权，然后在不需要的时候通过 revokeUriPermission 移除权限

② 配合 Intent.addFlags() 授权
既然这是一个 Intent 的 Flag，Intent 也提供了另外一种比较方便的授权方式，那就是使用 Intent.setFlags() 或者Intent.addFlag的方式

 intent.setFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
 intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);

使用这种形式的授权，权限截止于该 App 所处的堆栈被销毁。也就是说，一旦授权，知道该 App 被完全退出，这段时间内，该 App 享有对此 Uri 指向的文件的对应权限，我们无法主动收回该权限了

---

具体例子，调用系统播放器播放SD卡中的mp4

Intent intent = new Intent(Intent.ACTION_VIEW);
intent.setFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
String path = Environment.getExternalStorageDirectory() + "/temp_cloud_mp/" + itemsData.get(position).showUrl;
File file = new File(path);

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
    Uri contentUri = FileProvider.getUriForFile(getActivity(), BuildConfig.APPLICATION_ID + ".fileprovider", file);
    L.w("tan", "contentUri=" + contentUri.toString());
    intent.setDataAndType(contentUri, "video/*");
    startActivity(intent);
} else {
    Uri uri = Uri.fromFile(file);
    intent.setDataAndType(uri, "video/*");
    startActivity(intent);
    //7.0以前
    //File file = new File(path);
/*Uri uri = Uri.fromFile(file);
L.w("tan","contentUri="+uri.toString());
intent.setDataAndType(uri, "video/*");
startActivity(intent);*/

}