安卓FileProvider
来源:互联网 发布:淘宝cos店便宜 编辑:程序博客网 时间:2024/06/05 15:16
参考文档:
官方文档
FileProvider共享文件、缓存
FileProvider 是一个特殊的 ContentProvider 的子类,它使用 content://Uri
代替了 file:/// Uri
,更便利而且安全的为另一个 app 分享文件。
定义 FileProvider
在项目的 Manifest 文件中添加如下代码:
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
其中,
Android:name
属性固定为android.support.v4.content.FileProvider
;android:authorities
属性设置为com.yourdomain.fileprovider
格式,yourdomain
为你自己的项目包名;android:exported
属性设置为false
, FileProvider 不需要被其他程序访问;android:grantUriPermissions
属性设为true
, 以便允许你给特定文件进行临时授权。
如果你要覆盖 FileProvider 的属性,可以继承 FileProvider,继承的时候,FileProvider 要导入 android:name
中指定的全名,如下所示:
- 1
- 2
- 3
- 4
- 5
- 1
- 2
- 3
- 4
- 5
指定允许访问的文件路径
FileProvider 只能访问你预先指定的目录。可以使用 <paths>
子标签来指定要访问的文件路径。例如,下面的代码告诉 FileProvider, 我们打算访问 images/
子目录下的文件。
- 1
- 2
- 3
- 4
- 1
- 2
- 3
- 4
<paths>
标签必须包含一个或多个下述子标签的内容:
<files-path>
共享app内部的存储(等价于Context.getFilesDir()
返回的内容):
- 1
- 1
<cache-path>
共享内部缓存目录(等价于getCacheDir()
返回的内容):
- 1
- 1
<external-path>
共享外部的存储(等价于Environment.getExternalStorageDirectory()
返回的内容):
- 1
- 1
<external-files-path>
共享外部存储中与你的应用关联的目录(等于Context.getExternalFilesDir(String)
或Context.getExternalFilesDir(null)
返回的内容):
- 1
- 1
<external-cache-path>
共享外部存储中与你的应用关联的缓存目录(等价于Context.getExternalCacheDir()
返回的内容):
- 1
- 1
上述子标签都用到了下面两个属性:
name="name"
引号里的内容可以随便填,建议填有意义的内容。path="path"
path属性的值表示共享的具体路径。注意:path属性里指定的是路径,而不是某个特定文件。这里不能指定为一个文件,也不能用通配符指定为一组文件。
对每一个你想要请求的文件,都必须在 <paths>
标签下指定。例如,下面的 XML 标签指定了两个目录:
- 1
- 2
- 3
- 4
- 1
- 2
- 3
- 4
其中属性的意思:
path="images/"
就是你所要共享的文件路径;name="my_images"
就是告诉 FileProvider 用my_images
添加进 URI 内容字段去访问files/images/
的子目录。
然后就可以通过URI访问 app 的文件了:content://com.mydomain.fileprovider/my_images/default_image.jpg
。下文有关于获取该 Uri 的内容。
可以看到: com.mydomain.fileprovider
是我们在 AndroidManifest.xml 中指定的; myimages
:是我们指定的 name; default_image.jpg
:就是我们想要访问的图片了。
官方推荐的写法是,将 <paths>
标签及其子标签指定的内容放在项目下的一个 XML 文件中。例如,将它们放入 res/xml/file_paths.xml
文件中。
为了能使 FileProvider 访问到 file_paths.xml
文件,可在 <provider>
标签下加入一个 <meta-data>
子标签:
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
生成文件对应的 content URI
为了和其他应用共享文件,你需要生成该文件对应的 Content URI。
以下是共享文件的操作步骤:
首先: 为要共享的文件创建一个 File 对象;
然后: 将该 File 对象传入 getUriForFile()
,该方法会返回一个 content URI;
接着: 可以通过 Intent 将该 content URI 传递给其他应用或外部存储;
最后: 接收到该 content URI 的其他应用可以通过调用 ContentResolver.openFileDescriptor
得到一个 ParcelFileDescriptor
。
下面是一个官网的例子:
假设通过 一个权限为 com.mydomain.fileprovider
的 FileProvider 来获取在应用内部存储的子目录 image/
下的文件default_image.jpg
。
- 1
- 2
- 3
- 1
- 2
- 3
上述代码片段中,getUriForFile(...)
返回的 contentUri 的值为content://com.mydomain.fileprovider/my_images/default_image.jpg
。
给一个 URI 临时授权
为了给上述 contentUri 授予访问权限,可以采用下面的方法之一:
第一种
- 调用方法
Context.grantUriPermission(package, Uri, mode_flags)
。对于给定的 Uri, 这个方法根据 mode_flags 授予对指定 package 的临时访问权限。mode_flags 有FLAG_GRANT_READ_URI_PERMISSION
和FLAG_GRANT_WRITE_URI_PERMISSION
两个值。除非你调用revokeUriPermission()
撤销授权或者重启设备,这种授权将一直有效。
第二种
通过
setData()
将该 contentUri 放到一个 Intent 中;调用
Intent.setFlags()
方法,传入FLAG_GRANT_READ_URI_PERMISSION
或FLAG_GRANT_WRITE_URI_PERMISSION
,也可以两个都传入;最后,调用
setResult(int resultCode, Intent data)
返回授权给请求者。
通过 Intent 授予的权限在当请求 Activity 处于栈顶的时候有效。当该 Activity 所在的栈被清除时,授予的权限也会被自动清除掉。
值得注意的是,授予给一个 Activity 的权限也就是等于授予给该 Activity 所在应用的所有组件该权限。
向另一个应用提供 Content URI
有很多种方式向一个应用提供 content URI。
这部分信息建议看官网,很好理解,我就不翻译了。
- 安卓FileProvider
- 安卓7.0 安装应用与截图设置FileProvider冲突
- 安卓7.0拍照权限,FileProvider的最清晰的使用
- FileProvider
- FileProvider
- FileProvider
- FileProvider使用
- FileProvider使用
- 使用FileProvider
- FileProvider注意事项
- 使用FileProvider共享文件
- FileProvider文件分享
- FileProvider控件的使用
- Android7.0之FileProvider
- FileProvider的使用
- Android 7.0 FileProvider
- Android 7.0 FileProvider 使用说明
- Android N : FileProvider
- 链接保存
- java过滤器与拦截器
- mysql代码注释,练习用
- Linux功耗管理(24)_Linux PM QoS framework(3)_per-device PM QoS
- 【学习笔记三】- 动态添加元素绑定事件函数测试
- 安卓FileProvider
- 接口返回升级报场景授权编号错误
- 访问图像中每个像素的值 opencv
- 正睿OI noip2017冲刺 第一次考试T2 代码
- netty(十六)源码分析之服务端创建
- 17-08-30 JSP指令之page指令
- 洛谷p1404 平均数
- python学习(5):web网站开发利器Django框架
- Linux功耗管理(25_Linux电源管理(14)_从设备驱动的角度看电源管理)