WearOS开发：Jetpack Coil加载assets中GIF失败问题求助

1. 全局配置ImageLoader（关键） #

Coil的ImageLoader需要全局单例初始化，确保GIF解码逻辑生效且避免重复创建资源。在Application类中完成配置：

class MyWearApp : Application() {
    override fun onCreate() {
        super.onCreate()
        ImageLoader.Builder(this)
            .components {
                // 根据系统版本配置对应的GIF解码器
                if (Build.VERSION.SDK_INT >= 28) {
                    add(ImageDecoderDecoder.Factory())
                } else {
                    add(GifDecoder.Factory())
                }
            }
            .build()
            .also { Coil.setImageLoader(it) }
    }
}

2. 重构Composable加载函数 #

不用手动处理InputStream或BufferedSource，Coil支持直接解析file:///android_asset/格式的URI，同时利用自带的加载状态替代手动维护的loadingState：

@Composable
fun GifImage(filePath: String, modifier: Modifier = Modifier) {
    // 拼接assets目录下的GIF文件URI
    val assetUri = "file:///android_asset/dex/$filePath"
    
    AsyncImage(
        model = ImageRequest.Builder(LocalContext.current)
            .data(assetUri)
            .size(Size.ORIGINAL)
            .build(),
        contentDescription = null,
        modifier = modifier,
        placeholder = { Text("Loading") },
        error = { Text("加载失败") }
    )
}

3. 依赖检查 #

确保build.gradle中引入Coil的核心库和GIF扩展（适配不同Android版本）：

// Coil Compose核心依赖
implementation("io.coil-kt:coil-compose:2.5.0")
// GIF解码支持（Android 28以下需要）
implementation("io.coil-kt:coil-gif:2.5.0")

原代码问题分析 #

• 重复创建ImageLoader：每次Compose重组都新建实例，解码器配置无法持久化，导致GIF解码逻辑失效
• 资源泄漏风险：手动打开InputStream但未关闭，可能引发资源占用问题
• 加载状态逻辑错误：onSuccess触发时机过早，可能在GIF未完成解码时就显示静态帧
• 手动处理流冗余：Coil原生支持assets URI解析，手动处理BufferedSource可能破坏GIF的解码流程

验证注意事项 #

• 确认assets目录结构正确：shared/src/main/assets/dex/目标GIF文件.gif
• 测试不同API版本的WearOS设备/模拟器，尤其是Android 28以下版本
• 保持Coil依赖为最新稳定版，避免版本兼容问题

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