Android的FileProvider使用解释

Posted 2022-04-22 Jason_Lee155

前言

从android7.0 （N） 开始，严格执行 StrictMode 模式，也就是说，将对安全做更严格的校验。不允许在 App 间，使用 file:// 的方式，传递一个 File ，否则会抛出 FileUriExposedException的错误，会直接引发 Crash。

但是，既然官方对文件的分享做了一个这么强硬的修改（直接抛出异常），那么也提供了解决方案，那就是 FileProvider，通过 content://的模式替换掉 file://，同时，需要开发者主动升级 targetSdkVersion 到 24 才会执行此策略。

FileProvider是android support v4包提供的，是ContentProvider的子类，便于将自己app的数据提供给其他app访问。

在app开发过程中需要用到FileProvider的主要有

1. 相机拍照以及图片裁剪
2. 调用系统应用安装器安装apk（应用升级）

具体使用的方法

1、配置AndroidManifest文件，声明FileProvider

作用是什么呢？：FileProvider是ContentProvider子类，需要设置一个meta-data，里面指向一个xml文件。

  <provider
            android:name="android.support.v4.content.FileProvider"
            android:authorities="$applicationId.provider"
            android:exported="false"
            android:grantUriPermissions="true">
            <meta-data
                android:name="android.support.FILE_PROVIDER_PATHS"
                android:resource="@xml/provider_paths" />
        </provider>

authorities：一个标识，在当前系统内必须是唯一值，一般用包名。
exported：表示该 FileProvider 是否需要公开出去。
granUriPermissions：是否允许授权文件的临时访问权限。这里需要，所以是 true。

2、在res的建xml目录，放入provider_paths.xml文件

为什么要写这么个xml文件？
因为要使用content://uri替代file://uri，那么，content://的uri如何定义呢？不能直接使用文件路径。
所以，需要一个虚拟的路径对文件路径进行映射，所以需要编写个xml文件，通过path以及xml节点确定可访问的目录，通过name属性来映射真实的文件路径。

<?xml version="1.0" encoding="utf-8"?>
<paths>
    <external-path
        name="external_storage_root"
        path="." />
    <files-path
        name="files-path"
        path="." />
    <cache-path
        name="cache-path"
        path="." />
    <!--/storage/emulated/0/Android/data/...-->
    <external-files-path
        name="external_file_path"
        path="." />
    <!--代表app 外部存储区域根目录下的文件 Context.getExternalCacheDir目录下的目录-->
    <external-cache-path
        name="external_cache_path"
        path="." />
    <!--配置root-path。这样子可以读取到sd卡和一些应用分身的目录，否则微信分身保存的图片，就会导致 java.lang.IllegalArgumentException: Failed to find configured root that contains /storage/emulated/999/tencent/MicroMsg/WeiXin/export1544062754693.jpg，在小米6的手机上微信分身有这个crash，华为没有
-->
    <root-path
        name="root-path"
        path="" />
/paths>

这个配置的标签参照FileProvider里面的TAG配置。

TAG	Value	Path
TAG_ROOT_PATH	root-path	/
TAG_FILES_PATH	files-path	/data/data/<包名>/files
TAG_CACHE_PATH	cache-path	/data/data/<包名>/cache
TAG_EXTERNAL	external-path	/storage/emulate/0
TAG_EXTERNAL_FILES	external-files-path	/storage/emulate/0/Android/data/<包名>/files
TAG_EXTERNAL_CACHE	external-cache-path	/storage/emulate/0/Android/data/<包名>/cache

3、使用FileProvider，以安装apk为例：

  	        Intent intent = new Intent(Intent.ACTION_VIEW);
            intent.addCategory(Intent.CATEGORY_DEFAULT);
            Uri uri;
            File file = new File(saveFolder, updateSaveName);
            if (Build.VERSION.SDK_INT >= 24) //android 7.0以上
                //第二个参数："app的包名.fileProvider"
                uri = FileProvider.getUriForFile(activity, BuildConfig.APPLICATION_ID.concat(".provider"), file);
             else 
                uri = Uri.fromFile(file);
            
            String type = "application/vnd.android.package-archive";
            intent.setDataAndType(uri, type);
            intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
            if (Build.VERSION.SDK_INT >= 24) 
                intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
            
            activity.startActivityForResult(intent, 10);

总结

其实从简单用法就可以看出，Android7.0以上，不能随意就把文件（比如拍照图片）乱甩一个文件路径了。需要在FileProvider规定的几个路径下存放文件，才能生成uri传给另外的组件。就是这个意思。