Jetpack Compose中WindowWidthSizeClass预览参数提供者无法渲染预览

预览无报错但无法渲染，本质是Compose预览工具对WindowWidthSizeClass类型的参数序列化存在版本兼容问题：你查到的标记为已修复的官方工单，修复逻辑仅覆盖高版本IDE和依赖组合，低版本环境下，预览工具无法正确反序列化自定义PreviewParameterProvider返回的WindowWidthSizeClass实例——这个类是基于Int实现的内联值类，不是普通枚举，旧版预览工具没有针对这类值类做类型映射适配，就会出现静默渲染失败。

按优先级从高到低选择即可：

方案1：升级环境对齐官方修复版本 #

• 将Android Studio升级到2023.1.1（Hedgehog）及以上稳定版
• 将androidx.compose.material3:material3-window-size-class依赖升级到1.2.0及以上稳定版
• 保证androidx.compose.ui:ui-tooling-preview的版本和项目引入的Compose BOM版本完全一致，不要存在版本差
  升级完成后执行File -> Invalidate Caches，勾选清除文件系统缓存选项重启Android Studio，预览即可正常渲染。

方案2：用基础类型做中转，绕过值类兼容bug #

如果暂时无法升级IDE或依赖，可以把预览参数换成基础Int类型，在预览内部转换为对应尺寸类实例，完全绕开预览工具对非基础类型的序列化逻辑，修改后的代码如下：

class WindowWidthSizePreviewParameterProvider : PreviewParameterProvider<Int> {
    override val values: Sequence<Int> = sequenceOf(
        WindowWidthSizeClass.Compact.value,
        WindowWidthSizeClass.Medium.value,
        WindowWidthSizeClass.Expanded.value
    )
}

@Preview
@Composable
fun DualActionButtonsPreview(
    @PreviewParameter(WindowWidthSizePreviewParameterProvider::class) widthValue: Int,
) {
    MyTheme {
        val windowWidth = when(widthValue) {
            WindowWidthSizeClass.Medium.value -> WindowWidthSizeClass.Medium
            WindowWidthSizeClass.Expanded.value -> WindowWidthSizeClass.Expanded
            else -> WindowWidthSizeClass.Compact
        }
        DualActionButtons(windowWidth)
    }
}

这种写法兼容所有Compose预览版本，不需要升级环境就能正常生成三个尺寸档位的预览。

方案3：单独声明各尺寸预览（稳定性最高） #

如果不想做参数中转，可以直接为每个尺寸档位写独立的预览函数，完全不依赖PreviewParameterProvider，不存在任何兼容问题：

@Preview(name = "Compact宽度")
@Composable
fun DualActionButtonsCompactPreview() {
    MyTheme {
        DualActionButtons(WindowWidthSizeClass.Compact)
    }
}

@Preview(name = "Medium宽度")
@Composable
fun DualActionButtonsMediumPreview() {
    MyTheme {
        DualActionButtons(WindowWidthSizeClass.Medium)
    }
}

@Preview(name = "Expanded宽度")
@Composable
fun DualActionButtonsExpandedPreview() {
    MyTheme {
        DualActionButtons(WindowWidthSizeClass.Expanded)
    }
}

这种写法代码量稍多，但不会受任何预览工具版本bug影响，渲染成功率最高。

• 自定义的WindowWidthSizePreviewParameterProvider必须声明为public，不要写成私有类或内部类，否则预览工具无法通过反射读取类定义，也会导致渲染失败
• 预览函数内部不要引入依赖运行时Context、Activity实例的逻辑，这类逻辑会导致预览静默失败且不抛出明确报错
• 如果debug构建开启了混淆，需要将所有PreviewParameterProvider的子类加入混淆白名单，避免类被混淆后预览工具找不到对应实现

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