如何在不修改android:windowBackground的情况下更改Compose预览默认背景色

有几种无需改动主应用android:windowBackground的方案，既能统一设置预览背景，又不用逐个修改预览注解：

方案1：创建预览专用主题，通过@Preview指定 #

在原主题基础上，新增一个仅用于预览的主题，重写windowBackground为白色，之后在预览注解里指定该主题即可：

1. 在res/values/styles.xml中添加预览主题：

<style name="Theme.App.Preview" parent="Theme.App.Base">
    <item name="android:windowBackground">@color/white</item>
</style>

2. 修改预览代码，通过theme参数绑定预览专用主题：

@Preview(showBackground = true, theme = "@style/Theme.App.Preview")
@Composable
private fun HelloWorldPreview() {
    HelloWorld("Stack Overflow")
}

后续所有预览只需统一指定这个主题，要调整预览背景色时，仅修改该预览主题的配置即可。

方案2：封装通用预览包装Composable #

创建一个全局的预览包装组件，自动为所有预览添加白色背景，避免重复编写配置代码：

@Composable
fun PreviewWrapper(content: @Composable () -> Unit) {
    // 用Surface设置白色背景，可根据需求替换为其他颜色
    Surface(color = Color.White) {
        content()
    }
}

// 使用示例
@Preview(showBackground = true)
@Composable
private fun HelloWorldPreview() {
    PreviewWrapper {
        HelloWorld("Stack Overflow")
    }
}

这种方式灵活性更高，还能在Wrapper中添加其他通用预览配置，比如默认内边距、字体缩放等。

方案3：通过Compose MaterialTheme覆盖背景 #

如果项目已全面使用Compose MaterialTheme，可在预览中临时覆盖colorScheme.background：

@Preview(showBackground = true)
@Composable
private fun HelloWorldPreview() {
    MaterialTheme(
        colorScheme = MaterialTheme.colorScheme.copy(background = Color.White)
    ) {
        HelloWorld("Stack Overflow")
    }
}

该方案无需修改XML主题，适合纯Compose风格的项目。

内容的提问来源于stack exchange，提问作者m.reiter