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

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() 方法的使用还是很简单的，没什么需要额外交代的了。

4.2 MediaScannerConnection 原理

依然是从源码中找答案，我们先来看看 scanFile() 方法的实现。

在 scanFile() 里，创建了一个 MediaScannerConnection 并调用了 connect() 方法。接下来我们继续看 connect() 方法。

在 connect() 方法中，可以看到，它实际上是 bindServer() 了 MediaScannerService 这个系统服务，所有的操作都在 MediaScannerService 中。

MediaScannerService 的源码，有兴趣可以去这里查看：

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

这是一个系统服务，我到这里就不继续跟下去了，回过头来继续看源码。

不过看到 connect() 方法的时候，那对应的，一定有 disconnect() 方法存在了，前面 bindService() 了一个系统服务，我们一定要有一个时机去调用 unbindService()，否则就会造成泄露。

MediaScannerConnection 确实提供了 disconnect() 方法，但是我们通过 scanFile() 方法拿不到这个对象。这里处理的非常的巧妙，不需要我们手动去触发 disconnect()，它是自维护的。

继续看 scanFile() 里被我们忽略的 ClientProxy 类，逻辑都在这里面。

在 scanNextPath() 中，会去判断传递进去的文件路径是否都扫描过，如果已经没有更多需要扫描的路径了，就自己去调用 disconnect() 方法，回收资源。

到这里，也就解答了我们刚才的疑问，MediaScannerConnection 已经帮我们考虑了很多事情，我们只需要调用它的标准 API 就好了。

五、查缺补漏

5.1 扫描其他类型的媒体文件

最后

自我介绍一下，小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。

深知大多数初中级Android工程师，想要提升技能，往往是自己摸索成长，自己不成体系的自学效果低效漫长且无助。

因此我收集整理了一份《2024年Android移动开发全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友，同时减轻大家的负担。

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上Android开发知识点！不论你是刚入门Android开发的新手，还是希望在技术上不断提升的资深开发者，这些资料都将为你打开新的学习之门

如果你觉得这些内容对你有帮助，需要这份全套学习资料的朋友可以戳我获取！！

由于文件比较大，这里只是将部分目录截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且会持续更新！
开新的学习之门**

如果你觉得这些内容对你有帮助，需要这份全套学习资料的朋友可以戳我获取！！

由于文件比较大，这里只是将部分目录截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且会持续更新！