FileProvider是Android 7.0出现的新特性,它是ContentProvider的子类,可以通过创建一个Content URI并赋予临时的文件访问权限来代替File URI实现文件共享
FileProvider注册配置
- Manifest中声明FileProvider对象
- 在 Manifest.xml文件中注册 FileProvider;
support库:
<manifest>
...
<application>
...
<provider
android:name="android.support.v4.content.FileProvider"
android:authorities="<包名>.provider"
android:exported="false"
android:grantUriPermissions="true">
<meta-data
android:name="android.support.FILE_PROVIDER_PATHS"
android:resource="@xml/provider_paths"/>
</provider>
...
</application>
</manifest>
androidx库:
<manifest>
...
<application>
...
<provider
android:name="androidx.core.content.FileProvider"
android:authorities="<包名>.provider"
android:exported="false"
android:grantUriPermissions="true">
<meta-data
android:name="android.support.FILE_PROVIDER_PATHS"
android:resource="@xml/provider_paths"/>
</provider>
...
</application>
</manifest>
通常开发中,适配Android7.0主要就是适配其中文件访问权限。比如调用系统拍照,应用更新后安装功能都是涉及到。
在官方7.0的以上的系统中,尝试传递 file://URI可能会触发FileUriExposedException
在res的建xml目录,放入provider_paths.xml
文件
<?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>
下面有几种获取方式:
- paths
name:是一个文件别名,对外可见路径的一部分,隐藏真实文件目录 ;
path:是一个相对目录,相对于当前标签的根目录。path值为点符号(".")时,该根目录下所有的文件夹都可以临时授权访问。 - root-path:
表示设备的根目录,
对应File DEVICE_ROOT = new File("/")
目录路径:"/"; - files-path:
表示内部存储空间应用私有目录下的 files/ 目录,
对应Context.getFilesDir()
所获取的目录路径:/data/data/<包名>/files; - cache-path:
表示内部存储空间应用私有目录下的 cache/ 目录,
对应Context.getCacheDir()
所获取的目录路径:/data/data/<包名>/cache; - external-path:
表示外部存储空间根目录,
对应Environment.getExternalStorageDirectory()
所获取的目录路径:/storage/emulate/0; - external-files-path:
表示外部存储空间应用私有目录下的 files/ 目录,
对应Context.getExternalFilesDir()
所获取的目录路径:/storage/emulate/0/Android/data/<包名>/files; - external-cache-path:
表示外部存储空间应用私有目录下的 cache/ 目录,
对应Context.getExternalCacheDir()
所获取的目录路径:/storage/emulate/0/Android/data/<包名>/cache; - external-media-path:
表示外部媒体区域根目录中的文件,
对应Context.getExternalMediaDirs()
所获取的目录路径:/storage/emulated/0/Android/media/<包名>。 -
使用代码
-
private void showWeb() { File file = new File(Environment.getExternalStorageDirectory() + "/pdf/" + "test.pdf"); if (file.exists()) { Uri uri = FileProvider.getUriForFile(this, "包名.provider", file); String url = "file:///android_asset/pdfjs/web/viewer.html?file=" + uri; LogUtils.d("加载的文件url是:" + url); webView.loadUrl(url); } }