三种方法，刷新 Android 的 MediaStore！让你保存的图片立即出现在相册里！

最新推荐文章于 2024-09-02 16:34:40 发布

iblue007

最新推荐文章于 2024-09-02 16:34:40 发布

阅读量1.8k

点赞数

文章标签：相册

原文链接：https://www.cnblogs.com/plokmju/p/android_mediastore.html

版权

一、序

Hi，大家好，我是承香墨影！

App 内，创建一个文件并保存文件到本地的需求，是很常见的 I/O 操作。而如果这个文件变成了一张图片，那你涉及到的就不仅仅是一个 I/O 操作了，还需要考虑如何更新 MediaStore，这样才可以在系统相册中，看到它。

这里说的 MediaStore，本质上是 Android 维护的一个文件系统的数据库，它记录了当前磁盘上所有的文件索引，我们可以通过它，快速的查找当前系统的文件。

MediaStore 刷新的时机是不一定的，也就是说，保存的一张图片文件，MediaStore 并不会立即刷新文件系统，将此文件索引记录下来。而系统本身是存在一些自动刷新 MediaStore 的时机，例如：重启手机。表现就是，当你保存了一张图片到本地文件夹中之后，通过文件管理器类的 App，可以在目录下找到这涨照片，但是在系统相册中，是无法立即看到它的，同时你想用诸如微信、QQ 去分享这张图片的时候，也是找不到的。所以在我们保存图片文件之后，去触发系统刷新 MediaStore 就尤为重要了。

本文就来讲讲，如何在保存图片之后，刷新系统 MediaStore 那些事。

刷新系统 Media 通常有如下几种方式：

通过操作 MediaStore 类。
发送广播更新 MediaStore。
通过操作 MediaScannerConnection 类。

这三种方式，各有优缺点，我们慢慢分析。

二、操作 MediaStore

这里说的操作 MediaStore，实际是操作它的一个内部类 MediaStore.Image.Media，它提供了几个 inserImage () 方法，供我们向 MediaStore 中插入图片数据，并产生一个缩略图。

这个方法传递进去的是一个 Bitmap 对象，其余的 title 和 description 分别是图片文件的名称和一段描述。

举个 Kotlin 的例子：

MediaStore.Images.Media.insertImage(
        contentResolver,
        mShareBitmap!!,
        "image_file",
        "file")

使用 inserImage() 方法，不需要我们指定路径，会自动将图片保存至 Picture 目录下。它也不支持我们指定路径。如果我们对图片保存的路径没有要求，并且保存的是一个 Bitmap 对象，此方法是非常的方便的。

细心的朋友可能已经发现了 inserImage() 还有一个其他的重载方法，支持我们传递进去一个图片文件路径，不过我并不推荐使用这个方法，因为它会将原本的图片，再 Copy 一份，到 Picture 目录下，也就是说你最终在磁盘上会得到两张相同的图片。

这一点，看源码是最清晰的。它首先使用 BitmapFactory.decodeFile() 方法，得到一个 Bitmap，然后再去调用保存 Bitmap 对象的 inserImage() 方法，所以我们最终在磁盘上会有两张一模一样的图片。

三、发送广播

3.1 那些广播可以更新 MediaStore

说到广播，在 Android 4.4 之前，是可以通过 ACTION_MEDIA_MOUNTED 广播，来通知系统刷新 MediaStore 的，不过假如你现在还在依赖这条广播，你会得到一个错误信息。

E/AndroidRuntime(23718): java.lang.SecurityException: Permission Denial: not allowed to send broadcast android.intent.action.MEDIA_MOUNTED from pid=23718, uid=10097

在 Android 4.4 之后，这个广播只能由系统进行广播，App 只能对该广播进行监听，在当前的系统分布环境下，这条路已经走不通了。

这样设计也很好理解，毕竟扫描全盘是非常的耗资源，所以系统肯定要把全盘扫描的权限拿在自己手里不开放出来，避免被第三方 App 滥用。

不过 Android 依然给我们提供了替代方案，那就是用 MediaScannerConnection 或者发送 ACTION_MEDIA_SCANNER_SCAN_FILE 广播。

接下来就来说说 ACTION_MEDIA_SCANNER_SCAN_FILE 这个广播。

3.2 使用广播刷新

通过广播刷新 MediaStore 的方式非常的简单，只需要指定文件路径和 Action 就好了。

val saveAs = "Your_Created_Image_File_Path"
val contentUri = Uri.fromFile(File(saveAs))
val mediaScanIntent = Intent(Intent.ACTION_MEDIA_SCANNER_SCAN_FILE,contentUri)
sendBroadcast(mediaScanIntent)

正常情况下，它是没有问题的，不过假如你发现它不生效，就需要检查一下你文件的路径是否传递正确。

通过查看 MediaScannerReceiver 的源码，可以发现 onReceive() 方法中，针对 ACTION_MEDIA_SCANNER_SCAN_FILE 还有一个限制条件，那就是传递进去的文件绝对路径，必须是以 Environment.getExternalStorageDirectory() 方法的返回值开头。

有兴趣可以仔细阅读源码，这里是 Android 6.0 的源码：

http://androidxref.com/6.0.0_r1/xref/packages/providers/MediaProvider/src/com/android/providers/media/MediaScannerReceiver.java

本质上，还是 /mnt/sdcard/ 路径就认，而 /sdcard/ 就无法使用，所以只要我们不硬编码文件路径，这个问题基本上也就不存在。

这里也提醒我们，一定不要在代码里，硬编码文件路径，算是一个编码规范了。

3.3 删除文件后刷新MediaStore

本文一直都在说添加新文件的时候，如何刷新 MediaStore 的问题。但是其实还涉及到另外一个问题，我们删除了一个已经被收录在 MediaStore 中的文件，怎么办？在本文里也顺便讲一下。

既然放在这一小节讲，首先想到的是，直接再发一个广播出去，刷新这个路径，但是查阅最终执行扫描前的 MediaScanner 的 scanSingleFile() 方法，你就会知道这样的方式是行不通的。

在这里可以看到，当你传递进去的文件路径，指向的文件不存在的时候，会直接 return 出去了，就执行不到刷新的逻辑里。

所幸的是，我在 DownloadManager 类中，找到了刷新删除文件的解决办法，依然是通过 ContentResolver 来解决。

这里通过 ContentResolver 来向 MediaStore 中发起一个删除文件的操作，只需要传递进去一个文件的绝对路径即可。

四、操作 MediaScannerConnection 类

4.1 使用 MediaScannerConnection

刷新 MediaStore 还有一个最通用也是我推荐的一个方法，那就是使用 MediaScannerConnection 进行操作。

不同于 MediaStore.Image.Media 和广播的方式，使用 MediaScannerConnection 不仅可以保存文件，还可以指定文件路径，最好的就是，它还支持刷新完成的回调。

如果我们对时序有要求，并且需要制定文件保存路径的话，最好的方式就是直接使用 MediaScannerConnection 类进行操作，并且这也应该是兼容最好的方式。

这里我们主要是利用 MediaScannerConnection 类的 scanFile() 方法进行触发扫描。

通过 scanFile() 方法，我们只需要制定一个待刷新的文件路径和对应的 MimeType 即可，它支持传递多个路径，也可就是支持批量扫描。

注意这里的 MimeType 是一定要填写的，并且不能写通配符 */* 或 null，否则会导致刷新失败，通常我们保存的是一个图片的话，只需要传递 image/jpeg 即可。

最后一个参数， onScanCompletedListener 中可以监听我们扫描的结果，需要注意的是，假如这里扫描的是多个文件路径，它也会被回调多次。所以如果有什么在刷新之后的后续操作，就需要特殊处理一下（原因后面是说）。

MediaScannerConnection.scanFile(this
        , arrayOf(picFile.absolutePath)
        , arrayOf("image/jpeg"), { path, uri ->

    Log.i("cxmyDev", "onScanCompleted : " + path)

})

scanFile() 方法的使用还是很简单的，没什么需要额外交代的了。