前言
从Android7.0 (N) 开始,严格执行 StrictMode 模式,也就是说,将对安全做更严格的校验。不允许在 App 间,使用 file:// 的方式,传递一个 File ,否则会抛出 FileUriExposedException的错误,会直接引发 Crash。
但是,既然官方对文件的分享做了一个这么强硬的修改(直接抛出异常),那么也提供了解决方案,那就是 FileProvider,通过 content://的模式替换掉 file://,同时,需要开发者主动升级 targetSdkVersion 到 24 才会执行此策略。
FileProvider是android support v4包提供的,是ContentProvider的子类,便于将自己app的数据提供给其他app访问。
在app开发过程中需要用到FileProvider的主要有
- 相机拍照以及图片裁剪
- 调用系统应用安装器安装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传给另外的组件。就是这个意思。