Android之FileProvider的使用

提示:文章写完后,目录可以自动生成,如何生成可参考右边的帮助文档


一、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()

三、案例

猜你喜欢

转载自blog.csdn.net/dirksmaller/article/details/108204314
今日推荐