如何让Android 10/11的图库应用识别显示外部存储已保存图片

出现「文件真实存在、文件管理器可见、系统图库不可见」的现象，本质是保存流程没有同步给系统媒体索引库（MediaStore）写入可见的媒体记录。系统图库的加载逻辑完全依赖MediaStore的索引数据，而非直接扫描磁盘文件，索引缺失就会导致图库识别不到新保存的图片。而多数文件管理器会直接遍历磁盘目录读取文件，不依赖MediaStore索引，因此可以正常看到保存的图片。 #

1. Android 10（API29）以下版本的逻辑缺失 #

当前低版本分支只完成了文件写入磁盘的操作，完全没有触发系统媒体扫描流程。
在Android 9及更早的版本中，系统不会自动监听应用写入公共目录的文件，必须主动发送广播通知媒体扫描器扫描对应文件，才能把文件信息录入MediaStore数据库。没有这一步操作，图库自然无法感知新文件的存在。
修正方式：在Bitmap写入完成、输出流关闭后，添加广播通知逻辑：

fos?.use {
    bitmap.compress(Bitmap.CompressFormat.JPEG, 100, it)
    // 主动触发媒体扫描
    val scanIntent = Intent(Intent.ACTION_MEDIA_SCANNER_SCAN_FILE).apply {
        data = Uri.fromFile(image) // 传入流程中创建的File对象
    }
    context.sendBroadcast(scanIntent)
}

注：requestLegacyExternalStorage="true"对Android 9及更早版本没有作用，它仅对Android 10版本的存储权限逻辑做兼容，低版本的媒体索引必须靠主动广播触发。

2. Android 10及以上版本的标记遗漏 #

当前高版本分支走MediaStore插入条目逻辑时，漏掉了IS_PENDING状态标记的处理，这是高版本下图库看不到图片的最常见原因。
Android 10引入的IS_PENDING机制，是为了避免应用往MediaStore插入半成品文件（比如还没写完内容的损坏文件）时，图库提前展示坏图。如果不手动设置这个标记：

• 条目默认会被设为待处理状态，仅当前应用自己能查询到这个条目，系统图库等其他应用完全看不到
• 哪怕已经通过OutputStream把Bitmap内容写完，没有主动把待处理状态改成可用，条目永远不会对其他应用开放
  修正方式：调整ContentValues与流关闭后的更新逻辑：

val contentValues = ContentValues().apply {
    put(MediaStore.MediaColumns.DISPLAY_NAME, filename)
    put(MediaStore.MediaColumns.MIME_TYPE, "image/jpeg") // 替换原非标准的image/jpg写法
    put(MediaStore.MediaColumns.RELATIVE_PATH, Environment.DIRECTORY_PICTURES)
    // 插入时先标记为待处理
    put(MediaStore.Images.Media.IS_PENDING, 1)
}
// ... 拿到imageUri、打开输出流写入Bitmap...
// 写入完成、流关闭后，把标记改成可用
imageUri?.let { uri ->
    contentResolver.update(uri, ContentValues().apply {
        put(MediaStore.Images.Media.IS_PENDING, 0)
    }, null, null)
}

3. 额外适配提醒 #

• requestLegacyExternalStorage="true"的兼容能力仅在Android 10版本有效，Android 11（API30）及以上版本会完全忽略这个属性，所有公共目录的媒体文件操作必须走MediaStore API，不能再直接操作File路径
• 对于Android 6.0（API23）到Android 9的版本，WRITE_EXTERNAL_STORAGE属于危险权限，需要动态申请，观察到文件管理器能看到文件，说明这个权限已经正常获取，不属于本次问题的诱因

内容的提问来源于stack exchange，提问作者Idan Damri