指定ApiLevel的Compose预览未按预期切换配色问题咨询

为什么@Preview的apiLevel参数不生效？ #

@Preview注解中的apiLevel参数仅用于模拟不同API级别下的布局兼容性表现（比如旧版本系统对部分Compose组件的渲染差异），但它不会修改运行时的Build.VERSION.SDK_INT常量值。你的预览运行环境依然是当前Android Studio使用的SDK版本，因此Build.VERSION.SDK_INT >= Build.VERSION_CODES.S的判断始终为真，导致预览仍使用动态配色。

解决方法 #

要在预览中模拟不同SDK版本下的配色效果，你可以通过以下两种方式实现：

方案1：给AppTheme添加覆盖参数

修改AppTheme函数，增加一个可选参数用于手动覆盖SDK版本判断逻辑：

fun AppTheme(
    overrideSdkInt: Int = Build.VERSION.SDK_INT,
    isSystemInDarkTheme: Boolean = isSystemInDarkTheme(),
    content: @Composable () -> Unit
) {
    val colorScheme = when {
        overrideSdkInt >= Build.VERSION_CODES.S && isSystemInDarkTheme -> dynamicDarkColorScheme(LocalContext.current)
        overrideSdkInt >= Build.VERSION_CODES.S -> dynamicLightColorScheme(LocalContext.current)
        isSystemInDarkTheme -> darkColorScheme
        else -> lightColorScheme
    }

    MaterialTheme(
        colorScheme = colorScheme,
        content = content,
    )
}

随后在预览中传入指定的SDK级别：

@Preview(apiLevel = Build.VERSION_CODES.M)
@Composable
private fun HomeScreenPreview() {
    AppTheme(overrideSdkInt = Build.VERSION_CODES.M) {
        HomeScreen()
    }
}

方案2：预览中直接指定静态配色

如果仅需验证静态配色的显示效果，可跳过AppTheme，直接在预览中通过MaterialTheme指定静态配色：

@Preview(apiLevel = Build.VERSION_CODES.M)
@Composable
private fun HomeScreenPreview() {
    MaterialTheme(colorScheme = lightColorScheme) {
        HomeScreen()
    }
}

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