两个小解释: 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; }
作者:TheShy_ 原文出处