如何实现单张图片代表图片目录的Android图片画廊功能

1. 前置权限配置 #

根据目标运行的系统版本申请对应存储权限，不需要申请高危的全文件访问权限：

• Android 13及以上：申请READ_MEDIA_IMAGES权限
• Android 10 - 12：申请READ_EXTERNAL_STORAGE权限
• Android 9及以下：申请READ_EXTERNAL_STORAGE权限即可访问公共媒体目录，自有沙盒目录不需要额外权限

2. 媒体库扫描与文件夹分组 #

不要手动遍历本地文件夹，用系统ContentResolver查询媒体库，性能提升数倍，且能自动过滤无效媒体文件：

• 查询地址用MediaStore.Images.Media.EXTERNAL_CONTENT_URI，按图片添加时间倒序排列，保证取到的第一个图片是对应文件夹的最新图片
• 按Bucket_ID（系统给每个图片文件夹分配的唯一标识）分组，每个文件夹只保留第一张图片作为封面样本
• 可添加筛选规则过滤掉10KB以下的小体积缓存图，避免无效封面

示例代码：

val projection = arrayOf(
    MediaStore.Images.Media._ID,
    MediaStore.Images.Media.BUCKET_ID,
    MediaStore.Images.Media.BUCKET_DISPLAY_NAME
)
// 按添加时间倒序，保证每个分组第一个就是最新的图片
val cursor = contentResolver.query(
    MediaStore.Images.Media.EXTERNAL_CONTENT_URI,
    projection,
    "${MediaStore.Images.Media.SIZE} > ?", // 过滤小于10KB的图
    arrayOf("10240"),
    "${MediaStore.Images.Media.DATE_ADDED} DESC"
)

val processedFolderIds = hashSetOf<Long>()
val folderList = mutableListOf<ImageFolder>()

cursor?.use {
    while (it.moveToNext()) {
        val bucketId = it.getLong(it.getColumnIndexOrThrow(MediaStore.Images.Media.BUCKET_ID))
        // 已经处理过的文件夹直接跳过
        if (processedFolderIds.contains(bucketId)) continue
        
        processedFolderIds.add(bucketId)
        val imageId = it.getLong(it.getColumnIndexOrThrow(MediaStore.Images.Media._ID))
        val coverUri = ContentUris.withAppendedId(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, imageId)
        val folderName = it.getString(it.getColumnIndexOrThrow(MediaStore.Images.Media.BUCKET_DISPLAY_NAME))
        folderList.add(ImageFolder(bucketId, folderName, coverUri))
    }
}

3. 缩略图生成与加载 #

不要手动解码位图，避免OOM和性能问题，优先用系统API或者成熟图片加载库：

• Android 10及以上可以直接调用系统loadThumbnail方法，系统会自动根据你传入的期望大小返回采样后的缩略图，性能最优：

val thumbnailSize = Size(400, 400)
val thumbnail = contentResolver.loadThumbnail(coverUri, thumbnailSize, null)

• 全版本兼容方案直接用Glide、Coil等图片加载库，自带缩略图采样、缓存、生命周期绑定逻辑，只需要指定控件大小即可自动适配：

// Glide示例
Glide.with(context)
    .load(coverUri)
    .override(400, 400)
    .centerCrop()
    .placeholder(R.drawable.default_cover)
    .into(coverImageView)

4. 列表性能优化 #

• 把扫描得到的文件夹列表缓存到内存，不要每次列表滑动都重新查询媒体库
• 列表滑动时暂停图片加载，滑动停止后再恢复加载，减少UI卡顿
• 给封面控件设置固定大小，避免图片加载完成后控件重新布局导致列表跳动

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