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

公众号原标题：测试：“系统相册里怎么看不到我刚保存的图片，是我操作不对吗？”

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

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

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

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

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

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

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

二、操作 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_...

本质上，还是 /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() 方法的使用还是很简单的，没什么需要额外交代的了。
4.2 MediaScannerConnection 原理
依然是从源码中找答案，我们先来看看 scanFile() 方法的实现。
在 scanFile() 里，创建了一个 MediaScannerConnection 并调用了 connect() 方法。接下来我们继续看 connect() 方法。
在 connect() 方法中，可以看到，它实际上是 bindServer() 了 MediaScannerService 这个系统服务，所有的操作都在 MediaScannerService 中。
MediaScannerService 的源码，有兴趣可以去这里查看：
http://androidxref.com/6.0.0_...
这是一个系统服务，我到这里就不继续跟下去了，回过头来继续看源码。
不过看到 connect() 方法的时候，那对应的，一定有 disconnect() 方法存在了，前面 bindService() 了一个系统服务，我们一定要有一个时机去调用 unbindService()，否则就会造成泄露。
MediaScannerConnection 确实提供了 disconnect() 方法，但是我们通过 scanFile() 方法拿不到这个对象。这里处理的非常的巧妙，不需要我们手动去触发 disconnect()，它是自维护的。
继续看 scanFile() 里被我们忽略的 ClientProxy 类，逻辑都在这里面。
在 scanNextPath() 中，会去判断传递进去的文件路径是否都扫描过，如果已经没有更多需要扫描的路径了，就自己去调用 disconnect() 方法，回收资源。
到这里，也就解答了我们刚才的疑问，MediaScannerConnection 已经帮我们考虑了很多事情，我们只需要调用它的标准 API 就好了。
五、查缺补漏
5.1 扫描其他类型的媒体文件
在 Android 下，不仅仅只有图片，对于其他媒体文件，使用本文介绍的方法，也是适用的。
5.2 避免某个目录被 MediaStore 扫描
看完到这里应该会知道，哪怕我们什么都不做，在手机下次重启的时候，系统依然会去全盘扫描文件系统，更新 MediaStore。
但是有时候，我们有一些目录下的媒体文件，并不想让 MediaStore 扫描到，例如在 SDCard 上缓存的图片、图标等，这些我们都不想出现在系统相册内。
解决办法其实在官方文档中已经写了。
https://developer.android.com...
这里简单说一下，当不需要被 MediaStore 扫描的目录下，创建一个名为 .nomedia 的空文件，它将阻止媒体扫描程序读取这个目录下的媒体文件。也就无法通过 MediaStore 分享给其他程序。
当然，一些重要的文件，依然建议放在自己的私有目录下。
关于在 MediaStore 刷新图片，本文基本上就算是讲清楚了。我推荐的方法，是使用 MediaScannerConnection 来实现。
你看了本文，还有什么更多的问题可以在留言区讨论，如果觉得好，可以这篇文章，分享给你需要的朋友们。
今天在公众号后台回复成长『成长』，将会得到我整理的一些学习资料，也能回复『加群』，一起学习进步。
推荐阅读：
漫画：程序员，你能“管理”好你的产品经理吗？
App 多语言翻译，机器翻译也能快如闪电！