给网友们整理相关的编程文章,网友阙伟泽根据主题投稿了本篇教程内容,涉及到Android、FileProvider应用场景、Android、FileProvider、Android FileProvider应用场景相关内容,已被459网友关注,相关难点技巧可以阅读下方的电子资料。
Android FileProvider应用场景
前言
有部分同学只要是上传或者下载,只要用到了文件,不管三七二十一写个 FileProvider 再说。
不是每一种情况都需要使用 FileProvider 的,啥?你问行不行?有没有毛病?
这... 写了确实可以,没毛病!但是这没有必要啊。
如果不需要FileProvider就不需要定义啊,如果定义了重复的 FileProvider,还会导致清单文件合并失败,需要处理冲突,从而引出又一个问题,解决 FileProvider 的冲突问题,当然这不是本文的重点,网上也有解决方案。
这里我们只使用 FileProvider 来说,分析一下如下场景:
1.比如我们下载文件到SD卡,当然我们一般都下载到download目录下,那么使用这个文件,需要 FileProvider 吗?
不需要!因为他是共享文件夹中,并不是在沙盒中。
2.那我们把文件保存到沙盒中,比如 getExternalFilesDir
。那么我们使用这个沙盒中的文件,需要 FileProvider 吗?
3.看情况,如果只是把此文件上传到服务器,上传到云平台,也就是我们自己App使用自己的沙盒,是不需要 FileProvider 的
4.如果是想使用系统打开文件,或者传递给第三方App,那么是需要 FileProvider 的。
也就是说一般使用场景,我们只有在自己App沙盒中的文件,需要给别的App操作的时候,我们才需要使用 FileProvider 。
比较典型的例子是,下载Apk到自己的沙盒文件中,然后调用Android的Apk安装器去安装应用(这是一个单独的App),我们就需要 FileProvider 。
或者我们沙盒中的图片,需要发送到第三方的App里面展示,我们需要 FileProvider 。
话不多说,我们从常规的使用与示例上来看看怎么使用,清楚它的一些小细节。
一、常规使用与定义
一般来说没有什么特殊的需求,我们使用系统自带的 FileProvider 类来定义即可。
我们再清单文件注册我们的FileProvider
属性的一些说明:
- authorities 是标记我们这个ContentProvider的唯一标识,是一个用于认证的暗号,我们一般默认使用包名+fileprovider来定义。(能不能使用别的,可以,abcd都行,但是没必要)
- name 是具体的FileProvider类,如果是系统的,就用上面的这种,如果是自定义的,就写自定义FileProvider的全类名。
- exported 是否限制其他应用获取此FileProvider。
- grantUriPermissions 是否授权其他应用获取访问Uri权限,一般为true。
- meta-data 和下面的 name 都是固定的写法,重点是 resource 需要自己实现规则,定义哪些私有文件会被提供访问。
看看我们定义的file_path文件:
属性的含义如下:
- root-path 从SD卡开始找 例如 storage/emulated/0/Android/data/com.guadou.kt_demo/cache/pos/naixiao-1122.jpg
- external-path 从外置SD卡开始 例如 Android/data/com.guadou.kt_demo/cache/pos/naixiao-1122.jpg
- external-files-path 外置沙盒file目录 例如 pos/naixiao-1122.jpg (真实目录在 Android/data/com.guadou.kt_demo/cache/pos/)
- external-cache-path 外置沙盒cache目录 例如 naixiao-1122.jpg (真实目录在 Android/data/com.guadou.kt_demo/cache/)
- files-path 和上面的同理,只是在内置的data/data目录下面
- cache-path 和上面的同理,只是在内置的data/data目录下面
总共使用的就这么几个,大家可以看到我的定义,它是可以重复定义的。
比我我用到的这两个,是的同样类型的可以定义多个,
如果我定义了两个同类型的 external-cache-path ,他们的 name 你可以随便取,叫abc都行,主要是path , 推荐大家如果想暴露根目录就使用点. , 如果想暴露指定的目录就写对应的文件夹名称。
比我我现在有一个图片在这个目录下
storage/emulated/0/Android/data/com.guadou.kt_demo/cache/pos/naixiao-1122.jpg
通过 FileProvider 获取Uri 也是分优先顺序的。
比如我定义了pos的目录,那么打印如下:
打印Uri:content://com.guadou.kt_demo.fileprovider/naixiao_img/naixiao-1122.jpg
那我们现在把pos的去掉,只要这个。
那么打印就如下:
打印Uri:content://com.guadou.kt_demo.fileprovider/external_app_cache/pos/naixiao-1122.jpg
换了name,多了pos的路径。
那我们都去掉呢?只保留外置SD卡和SD卡的规则。
那么打印就如下:
打印Uri:content://com.guadou.kt_demo.fileprovider/external_file/Android/data/com.guadou.kt_demo/cache/pos/naixiao-1122.jpg
就走到了外置SD卡的规则中去了。
那我们再去掉外置卡的规则。此时定义如下
此时打印如下:
打印Uri:content://com.guadou.kt_demo.fileprovider/myroot/storage/emulated/0/Android/data/com.guadou.kt_demo/cache/pos/naixiao-1122.jpg
可以看到它的匹配规则是一层一层往上找的,那我们再去掉SD卡的规则呢。。。
那不就空了吗,此时就崩溃报错了,这样是真拿不到Uri了...
使用示例:
说到这里,我们还没有真的使用 FileProvider ,下面我们以一个图片实例为例子演示如何发送到系统的App
//测试FileProvider fun fileProvider1() { val drawable = drawable(R.drawable.chengxiao) val bd: BitmapDrawable = drawable as BitmapDrawable val bitmap = bd.bitmap FilesUtils.getInstance().saveBitmap(bitmap, "naixiao-1122.jpg") val filePath = FilesUtils.getInstance().sdpath + "naixiao-1122.jpg" YYLogUtils.w("文件原始路径:$filePath") val uri = FileProvider.getUriForFile(commContext(), "com.guadou.kt_demo.fileprovider", File(filePath)) YYLogUtils.w("打印Uri:$uri") //到系统中找打开对应的文件 openFile(filePath, uri) } private fun openFile(path: String, uri: Uri) { //取得文件扩展名 val extension: String = path.substring(path.lastIndexOf(".") + 1) //通过扩展名找到mimeType val mimeType = MimeTypeMap.getSingleton().getMimeTypeFromExtension(extension) YYLogUtils.w("mimeType: $mimeType") try { //构造Intent,启动意图,交由系统处理 startActivity(Intent().apply { //临时赋予读写权限 addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION or Intent.FLAG_GRANT_WRITE_URI_PERMISSION) //表示用其它应用打开 action = Intent.ACTION_VIEW //给Intent 赋值 setDataAndType(uri, mimeType) }) } catch (e: Exception) { e.printStackTrace() YYLogUtils.e("不能打开这种类型的文件") } }
很简单的一个例子,我们把drawable中的一个图片,保存到我们私有沙盒目录中,目录为
文件原始路径:/storage/emulated/0/Android/data/com.guadou.kt_demo/cache/pos/naixiao-1122.jpg
我们通过 FileProvider 拿到 content://开头的uri路径。然后通过Intent匹配找到对于的第三方App来接收。
运行结果如下:
打开了系统自带的图片查看器,还能编辑图片,查看信息等。
那么打印就如下:
打印Uri:content://com.guadou.kt_demo.fileprovider/external_app_cache/pos/naixiao-1122.jpg
content 是 scheme。
com.guadou.kt_demo.fileprovider 即为我们在清单文件中定义的 authorities,即是我们的FileProvider的唯一表示,在接收的时候作为host。
这样封装之后,当其他的App收到这个Uri就无法从这些信息得知我们的文件的真实路径,相对有安全保障。
其他场景中,比如沙盒中的Apk文件想要安装,也是一样的流程,我们需要赋予读写权限,然后设置DataAndType即可。代码的注释很详细,大家可以参考参考。
此时我们都是发送了一个Intent,让系统自己去匹配符合条件的Activity。那有没有可能我们自己做一个App去匹配它。
这... 好像还真行。
二、能不能自定义接收文件?
其实我们仿造系统的App的做法,我们在自定义的Activity中加入指定Filter即可,比如这里我需要接收图片,那么我定义如下的 intent-filter :
都是一些固定的写法,我们在Activity上指明,它可以接收图片数据,此时我们再回到第一个App,发送图片,看看运行的效果:
之前还是图片查看器,现在可以选择我们自己的App来接收图片数据了,但是我们如何接收数据呢?
其实都是一些固定的代码,主要是拿到input流,然后操作流的处理。
override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_receive_image) if (intent != null && intent.action == Intent.ACTION_VIEW) { val uri = intent.data YYLogUtils.w("uri: $uri") if (uri != null && uri.scheme != null && uri.scheme == "content") { val fis = contentResolver.openInputStream(uri) if (fis != null) { val bitmap = BitmapFactory.decodeStream(fis) //展示 if (bitmap != null) { val ivReveiverShow = findViewById(R.id.iv_reveiver_show) ivReveiverShow.setImageBitmap(bitmap) } } } } }
最简单的做法,直接根据uri打开输入流,然后我们可以通过 BitmapFactory 就可以拿到 Bitmap了,就能展示图片到ImageView上面。
效果如图:
甚至我们拿到了 input 流,我们还能对流进行copy 操作,把你的图片保存到我自己的沙盒目录中,例如:
override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_receive_image) if (intent != null && intent.action == Intent.ACTION_VIEW) { val uri = intent.data YYLogUtils.w("uri: $uri") if (uri != null && uri.scheme != null && uri.scheme == "content") { val fis = contentResolver.openInputStream(uri) if (fis != null) { val inBuffer = fis.source().buffer() val outFile = File(getExternalFilesDir("xiaoxiao"), "naixiao5566.jpg") outFile.sink().buffer().use { it.writeAll(inBuffer) inBuffer.close() } YYLogUtils.w("存放的路径:${outFile.absolutePath}") //展示 val ivReveiverShow = findViewById(R.id.iv_reveiver_show) ivReveiverShow.extLoad(outFile.absolutePath) } } } }
保存到自己的沙盒文件之后,我们看一看效果:
好像还真的能行,秀啊。
那此时有人还会有一个疑问,你这方法都是我主动的发送给别人去展示,去操作!这都不是事,关键是能不能让别人主动的来操作、玩弄我的沙盒文件?
比如我做的App想获取微信,支付宝这些别人的App的沙盒中的图片?行不行?有没有方法可以做到?
这...,你别逗我了。
三、能不能主动查询对方的沙盒?
转头一想,好像还真行,有操作空间啊... 既然 FileProvider 是继承自 ContentProvider 。那凭什么我们的App都能获取到别人App的数据库了,不能获取别人的沙盒文件呢?那数据库文件不也存在沙盒中么?
例如联系人App,我们开发的第三方App可以通过 ContentProvider 获取到联系人App中的联系人数据,那么只要第三方的App定义好对应的 ContentProvider 我不就能获取到它沙盒的文件了吗?
说到就做,我们先把FileProvider设置为可访问
是的,android:exported="true"
设置成功之后我们直接通过 contentResolver 去查询不就好了吗?
先运行一下试试! 运行就崩了?
什么鬼哦,看看FileProvider的代码,原来不允许开放
原来 FileProvider的 exported 和 grantUriPermissions 都是指定的写法,不能改变,并且不允许暴露,不允许给别的App主动访问!
这和我们的需求不符合啊,我就要主动访问,既然你不行,那我不用你行了吧!我继承 ContentProvider 行了吧!我自己实现文件获取、Cursor封装行了吧!
不皮了,其实我们直接通过继承 ContentProvider 并且允许 exported
,然后我们通过自己实现的query方法,返回指定的Cursor信息,就可以实现!
部分代码如下:
public class MyFileProvider extends ContentProvider { @Override public void attachInfo(Context context, ProviderInfo info) { super.attachInfo(context, info); mStrategy = getPathStrategy(context, info.authority); } @Override public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) { YYLogUtils.w("走到query方法"); final File file = mStrategy.getFileForUri(uri); YYLogUtils.w("file:" + file); if (!file.exists()) { return null; } boolean directory = file.isDirectory(); if (directory) { YYLogUtils.w("说明是文件夹啊!"); File[] files = file.listFiles(); for (File childFile : files) { if (childFile.isFile()) { String name = childFile.getName(); String path = childFile.getPath(); long size = childFile.length(); Uri uriForFile = mStrategy.getUriForFile(childFile); YYLogUtils.w("name:" + name + " path:" + path + " size: " + size +" uriForFile:"+uriForFile); } } //自己遍历封装Cursor实现 return null; } else { YYLogUtils.w("说明是文件啊!"); if (projection == null) { projection = COLUMNS; } String[] cols = new String[projection.length]; Object[] values = new Object[projection.length]; int i = 0; for (String col : projection) { if (OpenableColumns.DISPLAY_NAME.equals(col)) { cols[i] = OpenableColumns.DISPLAY_NAME; values[i++] = file.getName(); } else if (OpenableColumns.SIZE.equals(col)) { cols[i] = OpenableColumns.SIZE; values[i++] = file.length(); } } cols = copyOf(cols, i); values = copyOf(values, i); final MatrixCursor cursor = new MatrixCursor(cols, 1); cursor.addRow(values); return cursor; } } }
我简单的做了文件和文件夹的处理,并不完整,如果是文件我们可以直接返回一个简单的cursor,如果是文件夹需要大家自己拼接子文件的cursor并返回。
接下来我们看看其他App如何主动这些文件,在另一个App中我们先加上权限:
...
然后我们直接使用 contentResolver.query
private fun queryFiles() { val uri = Uri.parse("content://com.guadou.kt_demo.fileprovider/external_app_cache/pos/naixiao-1122.jpg") val cursor = contentResolver.query(uri, null, null, null, null) if (cursor != null) { while (cursor.moveToNext()) { val fileName = cursor.getString(cursor.getColumnIndex("_display_name")); val size = cursor.getLong(cursor.getColumnIndex("_size")); YYLogUtils.w("name: $fileName size: $size") Toast.makeText(this, "name: $fileName size: $size", Toast.LENGTH_SHORT).show() } cursor.close() } else { YYLogUtils.w("cursor-result: 为空啊") Toast.makeText(this, "cursor-result: 为空啊", Toast.LENGTH_SHORT).show() } }
如果我们知道它的指定文件Uri,我们可以通过query查询到文件的一些基本信息。具体是哪些信息,需要对方提供和定义。
如果想操作对方的文件,由于我们已经拿到了对方的Uri,我们可以直接通过inputStream来操作,例如:
val fis = contentResolver.openInputStream(uri) if (fis != null) { val inBuffer = fis.source().buffer() val outFile = File(getExternalFilesDir(null), "abc") outFile.sink().buffer().use { it.writeAll(inBuffer) inBuffer.close() } YYLogUtils.w("保存文件成功") }
这些都是简单的基本操作,重点是如果我不知道具体的文件呢?
我就想把对方App的沙盒中的文件夹下面的全部文件都拿到,行不行?
行!只要对方App配合就行,例如:
private fun queryFiles() { val uri = Uri.parse("content://com.guadou.kt_demo.fileprovider/external_app_cache/pos/") val cursor = contentResolver.query(uri, null, null, null, null) if (cursor != null) { while (cursor.moveToNext()) { val fileName = cursor.getString(cursor.getColumnIndex("_display_name")); val size = cursor.getLong(cursor.getColumnIndex("_size")); val uri = cursor.getString(cursor.getColumnIndex("uri")); val fileUri = Uri.parse(uri) //就可以使用IO或者BitmapFactory来操作流了 YYLogUtils.w("name: $fileName size: $size") Toast.makeText(this, "name: $fileName size: $size", Toast.LENGTH_SHORT).show() } cursor.close() } else { YYLogUtils.w("cursor-result: 为空啊") Toast.makeText(this, "cursor-result: 为空啊", Toast.LENGTH_SHORT).show() } }
这样就是把对方外置SD卡下面的cache目录下的pos目录下的全部文件拿到手,当然了,这个需要对方App封装对应的cursor才行哦。
打印的Log如下:
只要对方封装的Cursor,我们可以把名字,大小,uri等信息都封装到Cursor中,提供给对方获取。
总结
FileProvider的主要应用场景就是分享,把自己沙盒中的文件分享,主动提供给其他匹配的App去使用。
使用其他App的图片?查询了目前市场上的主流App,微信,支付宝,闲鱼,美团,等App,例如在保存文件的时候都没有存在自己的沙盒中了,都是默认在DCIM或Pictures中,并存入 MediaStore 保存到图库中。
这样就算公共目录,无需FileProvider,大家直接通过 MediaStore 就能获取和使用。
而如果想主动访问其他App的沙盒文件,则需要对方App全方位配合,一般用于自家App的全家桶之类的应用。相对来说相对应用场景比较少。
不是做不到,只是大家觉得没有必要而已,毕竟定义和使用相对复杂,并且有暴露风险,被攻击的风险等。
本文全部代码均以开源,源码在此
以上就是Android中FileProvider的各种场景应用详解的详细内容,更多关于Android FileProvider应用场景的资料请关注码农之家其它相关文章!