Coil本地文件缩略图缓存咨询：重复生成Bitmap优化方案

一、Coil对本地文件缩略图的缓存支持 #

Coil默认的内存缓存会暂存解码后的Bitmap，但磁盘缓存仅针对网络资源的原始数据，不会自动缓存本地文件解码后的缩略图。要实现本地缩略图的持久化缓存，需要自定义缓存策略。

二、解决视频缩略图重复生成的最佳方案 #

针对coil-videoframedecoder每次重新生成Bitmap的问题，推荐自定义磁盘缓存+Coil拦截器+内存缓存的组合方案，具体步骤如下：

1. 生成唯一缓存Key #

为每个本地文件的缩略图请求生成唯一标识，需包含文件路径、缩略图尺寸、视频帧位置（如果自定义非首帧），确保相同参数的请求能命中缓存：

fun generateCacheKey(filePath: String, size: Size, framePosition: Long = 0): String {
    return "${filePath}_${size.width}x${size.height}_$framePosition"
}

2. 实现本地磁盘缓存逻辑 #

直接利用应用的缓存目录存储解码后的Bitmap，封装保存和读取方法：

// 保存缩略图到本地缓存
fun saveThumbnailCache(context: Context, key: String, bitmap: Bitmap) {
    val cacheDir = File(context.cacheDir, "video_thumbnails")
    cacheDir.mkdirs()
    val cacheFile = File(cacheDir, "$key.jpg")
    bitmap.compress(Bitmap.CompressFormat.JPEG, 80, FileOutputStream(cacheFile))
}

// 从本地缓存读取缩略图
fun loadThumbnailCache(context: Context, key: String): Bitmap? {
    val cacheFile = File(context.cacheDir, "video_thumbnails/$key.jpg")
    return if (cacheFile.exists()) BitmapFactory.decodeFile(cacheFile.path) else null
}

3. 配置Coil拦截器拦截请求 #

通过Coil的Interceptor在请求前检查本地缓存，命中则直接返回缓存内容，未命中则解码后写入缓存：

val imageLoader = ImageLoader.Builder(context)
    .components {
        add(VideoFrameDecoder.Factory())
    }
    .interceptor(object : Interceptor {
        override suspend fun intercept(chain: Interceptor.Chain): ImageResult {
            val request = chain.request
            val data = request.data
            // 仅拦截本地视频文件请求
            if (data is File && data.isFile && data.extension in listOf("mp4", "avi", "mov", "mkv")) {
                val cacheKey = generateCacheKey(data.path, request.size)
                // 优先加载本地缓存
                loadThumbnailCache(context, cacheKey)?.let { bitmap ->
                    return SuccessResult(
                        drawable = BitmapDrawable(context.resources, bitmap),
                        request = request,
                        metadata = Metadata(memoryCacheKey = cacheKey)
                    )
                }
                // 缓存未命中，执行原请求解码
                val result = chain.proceed(request)
                // 解码成功后写入缓存
                if (result is SuccessResult && result.drawable is BitmapDrawable) {
                    saveThumbnailCache(context, cacheKey, (result.drawable as BitmapDrawable).bitmap)
                }
                return result
            }
            return chain.proceed(request)
        }
    })
    // 优化内存缓存配置，减少Bitmap重复生成
    .memoryCache {
        MemoryCache.Builder(context)
            .maxSizePercent(0.25) // 占用应用可用内存的25%
            .build()
    }
    .build()

4. 添加缓存清理机制 #

避免缓存无限占用空间，可在文件删除时清理对应缓存，或定期清理过期缓存：

// 删除单个文件的缩略图缓存
fun deleteThumbnailCache(context: Context, key: String) {
    val cacheFile = File(context.cacheDir, "video_thumbnails/$key.jpg")
    if (cacheFile.exists()) cacheFile.delete()
}

// 清理7天前的过期缓存
fun cleanExpiredThumbnailCache(context: Context) {
    val cacheDir = File(context.cacheDir, "video_thumbnails")
    cacheDir.listFiles()?.forEach { file ->
        if (System.currentTimeMillis() - file.lastModified() > 7 * 24 * 60 * 60 * 1000) {
            file.delete()
        }
    }
}

三、额外优化提示 #

• 不同尺寸的缩略图要单独缓存，避免尺寸不匹配导致显示失真；
• 若需要截取视频非首帧，需将帧位置参数加入缓存Key；
• 可结合LruCache封装内存级别的缩略图缓存，进一步提升加载速度。

内容的提问来源于stack exchange，提问作者Muhammed naseef Koppilakkal