Jetpack Compose(Glance) Widget加载Bitmap后未重组问题排查

DevOps 小满

2026-8-1

问题分析与解决方案

你的核心问题是状态未使用Glance可观察容器，导致变量变更无法触发重组。普通var变量不属于可观察状态，Glance无法感知其值的变化，所以即使coinImage被成功赋值，Widget也不会触发UI更新。

解决步骤：

1. 将普通变量替换为可观察状态

用Glance提供的mutableStateOf定义状态变量，确保状态变化能被框架检测到：

// 替换原来的 var coinImage: Bitmap? = null
var coinImage by mutableStateOf<Bitmap?>(null)

2. 确保状态更新在主线程执行

图片下载通常在后台线程完成，更新状态时需切换到主线程，否则状态变更可能无法被Glance捕获：

// 下载完成后更新状态的代码块
val bitmap = imageRequest.execute().drawable.toBitmap()
withContext(Dispatchers.Main) {
    coinImage = bitmap
}

3. 确认UI组合逻辑依赖状态变量

在Glance的Content组合函数中，必须直接依赖coinImage的状态值，这样状态变化时才会触发对应UI的重组：

GlanceContent {
    Column(
        modifier = GlanceModifier.fillMaxSize(),
        verticalAlignment = Alignment.CenterVertically,
        horizontalAlignment = Alignment.CenterHorizontally
    ) {
        if (coinImage == null) {
            CircularProgressIndicator()
        } else {
            Image(
                bitmap = coinImage,
                contentDescription = "Coin icon",
                modifier = GlanceModifier.size(48.dp)
            )
        }
        // 其他UI元素
    }
}