提示:文章写完后,目录可以自动生成,如何生成可参考右边的帮助文档
文章目录
一、FileProvider是什么?
FileProvider是一个ContentProvider的子类,它取代了“file://”形式的Uri 通过“content://”形式的Uri实现了App间的安全通信。content Uri 可以赋予你临时的读写权限。当你创建一个包含ContentUri的Intent,并且打算将Intent发送给一个ClientApp,你可以通过该Intent.setFlags来设置权限。并且只要接收activity所在的栈是存活的,这些权限之于ClientApp都是可用的。同理,对于一个发给Service的Intent,只有这个Service是运行的,这些权限也是可用的。
相比较而言,file Uri形式,必须通过修改对应的文件的系统权限,来实现文件间的共享,这是不安全的。conent Uri提高了的文件访问安全性使得FileProvider成为了Android安全框架的一个核心点。
二、FileProvider使用步骤
1.定义一个FileProvider
<manifest>
...
<application>
...
<provider
android:name="androidx.core.content.FileProvider"
android:authorities="com.mydomain.fileprovider"
android:exported="false"
android:grantUriPermissions="true">
...
</provider>
...
</application>
</manifest>
由于FileProvider的默认功能中包含了 文件的Content Uri 的生成功能了,所以不必创建并声明其子类进行使用。并且你可以通过在XML直接指定FileProvider即可(注意其结点为Provider)。
属性:
grantUriPermissions:是否授予临时权限
exported: 是否将该Provider暴露给外部应用,设置为false即可
2.指定可访问的文件
FileProvider实例只能够为你预先指定的目录下的文件生成Content Uri。你需要在xml中paths的子结点下指定存文件目录、储区域或者存储路径。如下所示,paths告知了FileProvider你期望为你私有文件区域的image子目录请求Uri。
<paths xmlns:android="http://schemas.android.com/apk/res/android">
<files-path name="my_images" path="images/"/>
...
</paths>
目录结点和Android中代码的对应关系
结点 | 代码 |
---|---|
files-path | Context.getFilesDir() |
cache-path | getCacheDir() |
external-path | Environment.getExternalStorageDirectory() |
external-files-path | Context#getExternalFilesDir(String) Context.getExternalFilesDir(null) |
external-cache-path | Context.getExternalCacheDir() |
external-media-path | Context.getExternalMediaDirs() //API 21+ |
xml 属性:
1) name=“name”
一个Uri的路径段,处于安全性考虑,该值隐藏了你正在分析的目录名称。这个目录名称包含于path属性之中
2) path=“path”
你将要分享的子目录。尽管name属性是uri路径的一部分,但是path的value才是一个实际的文件名。注意这是一个文件夹名称,不是一个文件。
在XML中指定要共享的文件夹
<provider
android:name="androidx.core.content.FileProvider"
android:authorities="com.mydomain.fileprovider"
android:exported="false"
android:grantUriPermissions="true">
<meta-data
android:name="android.support.FILE_PROVIDER_PATHS"
android:resource="@xml/file_paths" />
</provider>
通过meta-data指定一个file_paths文件。
3.获取指定文件的Uri
为了通过content Uri 实现应用间 共享文件,你的app 必须生成一个content Uri。那怎么生成content Uri呢? 你需先针对要分享的文件实例化一个File对象,然后将其传给getUriForFile()方法。再然后将返回值通过Intent传给另一个Intent。接收到Intent的app能够打开并且访问它的内容,通过ParcelFileDescriptor(ContentResolver.openFileDescriptor实现FD解析)。
File imagePath = new File(Context.getFilesDir(), "images");
File newFile = new File(imagePath, "default_image.jpg");
Uri contentUri = getUriForFile(getContext(), "com.mydomain.fileprovider", newFile);
上述代码段返回的结果是:
content://com.mydomain.fileprovider/my_images/default_image.jpg.
4.授予临时权限给Uri
方式一:
Context.grantUriPermission(package, Uri, mode_flags)
调用上述方法,实现读写权限的设置。该权限一直有效,除非调用revokeUriPermission()方法或者重启手机
方式二:
1)通过Intent.setData设置一个ContentUri参数
2)Intent.setFlags()设置读写权限
3)通常调用setResult发送Intent到另一个App。
5.提供Uri给其他App
startActivityResult();
setResult();
Intent.setClipData()
三、案例
略