Android Glance带背景图按钮抛出异常：原因及解决办法咨询

问题重现 #

尝试通过Glance创建带图标的按钮时，给Button设置图片背景抛出异常：

原代码 #

@Composable
@GlanceComposable
internal fun ReloadButton(
    modifier: GlanceModifier = GlanceModifier,
    onClick: () -> Unit,
) {
    Button(
        text = "",
        onClick = { onClick() },
        modifier =
            modifier.background(
                imageProvider = ImageProvider(R.drawable.ic_refresh),
            ).size(Grid.FOUR),
    )
}

异常信息 #

java.lang.IllegalStateException: There is no use case yet to support this colorFilter in S+ versions.
at androidx.glance.appwidget.translators.ImageTranslatorKt.applyColorFilter(ImageTranslator.kt:145)
at androidx.glance.appwidget.translators.ImageTranslatorKt.translateEmittableImage(ImageTranslator.kt:72)

原因分析 #

Glance的Button组件background参数的设计初衷是设置纯色背景，而非图片背景。在API 31（Android S）及以上版本中，Glance的ImageTranslator处理图片背景时会尝试应用默认颜色滤镜，但当前版本的Glance并未实现该场景下的滤镜逻辑，因此抛出异常。另外，Glance基于RemoteViews实现，而RemoteViews对Button的图片背景支持本身存在限制，这也是底层诱因之一。

可行解决办法 #

方案1：使用Button内置的icon参数（推荐） #

Glance的Button组件本身提供了icon参数，专门用于设置按钮图标，这是官方推荐的标准用法，无需通过背景图实现：

@Composable
@GlanceComposable
internal fun ReloadButton(
    modifier: GlanceModifier = GlanceModifier,
    onClick: () -> Unit,
) {
    Button(
        text = "", // 保持文本为空
        onClick = onClick,
        icon = Icon(ImageProvider(R.drawable.ic_refresh), contentDescription = "Reload"),
        modifier = modifier.size(Grid.FOUR)
    )
}

方案2：自定义可点击图标（优化体验版） #

如果需要更灵活的样式，可使用Box包裹Image，配合clickable修饰符实现按钮功能，并添加按压反馈提升Widget交互体验：

@Composable
@GlanceComposable
internal fun ReloadButton(
    modifier: GlanceModifier = GlanceModifier,
    onClick: () -> Unit,
) {
    val interactionSource = remember { MutableInteractionSource() }
    val isPressed = interactionSource.collectIsPressedAsState().value

    Box(
        modifier = modifier
            .size(Grid.FOUR)
            .clickable(
                interactionSource = interactionSource,
                indication = rememberRipple(), // 添加波纹按压反馈
                onClick = onClick
            ),
        contentAlignment = Alignment.Center
    ) {
        Image(
            provider = ImageProvider(R.drawable.ic_refresh),
            contentDescription = "Reload",
            modifier = GlanceModifier
                .alpha(if (isPressed) 0.7f else 1.0f) // 按压时降低透明度强化反馈
        )
    }
}

注意：rememberRipple()依赖Glance交互能力，确保你的项目依赖了androidx.glance:glance-appwidget的最新版本。

为什么不推荐直接用Image替代？ #

基础的Image加clickable实现缺少原生按钮的按压反馈（如波纹、状态变化），上述方案2通过interactionSource和indication补充了这些细节，更贴近用户熟悉的按钮交互体验。

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