Kotlin调用Android默认相册组件打开指定路径仅显示最近图片问题求解

• 你当前使用的Intent.ACTION_GET_CONTENT本身不支持指定自定义初始路径，系统默认只会展示最近访问的媒体文件，你拼接的uri没有传入意图，完全不会生效
• 你生成uri的逻辑存在错误：getExternalFilesDir返回的是应用私有的pictures目录，默认系统相册没有权限访问这个路径下的文件，自然扫描不到对应内容
• 你没有适配不同安卓版本的存储权限，媒体库无法读取未授权路径的文件
• 你当前的代码逻辑完全没有用到FileProvider相关配置，自然无法让第三方应用访问你的应用私有目录文件

1. 声明并动态申请存储权限 #

在AndroidManifest.xml中添加权限声明：

<!-- Android 12及以下版本存储权限 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="32" />
<!-- Android 13及以上版本图片读取权限 -->
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />

注意必须在调用相册方法前动态申请以上权限，仅静态声明不会生效。

2. 通知媒体库扫描目标路径文件 #

系统相册只会读取媒体库数据库中录入的图片，你需要先把目标路径下的图片通知媒体库扫描录入：

// 通知媒体库扫描单个图片文件
private fun scanSingleImage(filePath: String) {
    val scanIntent = Intent(Intent.ACTION_MEDIA_SCANNER_SCAN_FILE)
    scanIntent.data = Uri.fromFile(File(filePath))
    requireActivity().sendBroadcast(scanIntent)
}

3. 修复后的相册调用代码 #

fun dispatcherGalleryImage(){
    try {
        // 获取目标目录路径，不要做无意义的字符串替换
        val targetPicDir = requireActivity().getExternalFilesDir(Environment.DIRECTORY_PICTURES) ?: return
        // 扫描目录下所有图片文件，录入媒体库
        targetPicDir.listFiles()?.forEach { file ->
            if (file.extension.lowercase() in setOf("jpg", "jpeg", "png", "webp")) {
                scanSingleImage(file.absolutePath)
            }
        }
        // 使用ACTION_PICK访问媒体库图片，支持设置初始路径
        val intent = Intent(Intent.ACTION_PICK, MediaStore.Images.Media.EXTERNAL_CONTENT_URI)
        intent.type = "image/*"
        // 安卓10及以上支持设置初始展示的URI
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
            intent.putExtra(Intent.EXTRA_INITIAL_URI, MediaStore.Images.Media.getContentUri(MediaStore.VOLUME_EXTERNAL))
        }
        startActivityForResult(intent, TAKE_GALLERY_IMAGE)
    }catch (ex: Exception){
        Log.e("GalleryError", ex.stackTraceToString())
    }
}

如果需要仅展示你的应用私有目录下的图片，建议不要调用系统相册，自己实现简易的图片选择器直接读取对应目录下的文件，不需要依赖系统媒体库的扫描逻辑。

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