005 主题、Material3 与资源：我在 Compose 中的样式管理心得

今天我想和你聊聊在 Jetpack Compose 中如何管理主题和资源。从 XML 世界过渡过来时，我花了一些时间才适应这套新的设计语言系统，但现在回过头看，Compose 的这套方案其实更加直观和灵活。

1. Theme 在 Compose 中的位置：你的样式总管家

在传统的 XML 开发中，我们习惯在 themes.xml 里定义 colorPrimary、字体等样式属性。而在 Compose 的世界里，MaterialTheme 成为了新的样式中心，它统一管理着 colorScheme（颜色方案）、typography（字体排印）和 shapes（形状）这三驾马车。

我的习惯是在应用的根 Composable 外包裹一层自定义的 Theme，就像下面这样：

@Composable
fun MyAppTheme(
    darkTheme: Boolean = isSystemInDarkTheme(),
    content: @Composable () -> Unit
) {
    val colorScheme = if (darkTheme) darkColorScheme() else lightColorScheme()
    MaterialTheme(
        colorScheme = colorScheme,
        typography = Typography,
        shapes = Shapes,
        content = content
    )
}

你可以这样理解：在 Activity 中调用 setContent { MyAppTheme { ... } }，其作用就类似于以前先 setTheme(R.style.xxx) 再 setContentView。它为你包裹的所有子组件定下了样式的基调。

2. 使用颜色与字体：告别硬编码

在 Compose 中使用主题颜色和字体非常直接。我不再需要去记忆十六进制色值，而是直接从主题中获取：

Text(
    text = "标题",
    color = MaterialTheme.colorScheme.primary,
    style = MaterialTheme.typography.titleMedium
)

这让我想起了 XML 中的写法：android:textColor="?attr/colorPrimary"。两者思路一脉相承，但 Compose 的语法更简洁，而且是类型安全的。

3. 字符串资源：为国际化做好准备

即使你的应用暂时只支持一种语言，我也强烈建议你从一开始就使用字符串资源。在 Compose 中，你可以这样获取：

import androidx.compose.ui.res.stringResource

Text(text = stringResource(id = R.string.app_name))

如果需要带参数的格式化字符串，写法也很直观：

Text(text = stringResource(id = R.string.welcome_user, userName))

对应的 strings.xml 需要这样定义：

<string name="welcome_user">欢迎，%1$s</string>

4. 尺寸与整数：保持 UI 的一致性

对于间距、尺寸等资源，Compose 也提供了对应的支持。我通常这样使用：

import androidx.compose.ui.res.dimensionResource

val pad = dimensionResource(id = R.dimen.page_padding)
Modifier.padding(pad)

这能确保整个应用中使用相同含义的尺寸值，维护起来方便多了。

5. 主题覆盖局部：灵活的样式微调

有时候，我们只需要在某个小范围内调整主题。Compose 为此提供了非常优雅的解决方案，类似于以前 View 系统里的 ContextThemeWrapper：

MaterialTheme(
    colorScheme = MaterialTheme.colorScheme.copy(primary = Color.Red)
) {
    Button(onClick = {}) { Text("仅此处主色不同") }
}

通过 copy 并覆盖特定属性，你可以轻松创建出一个局部的主题变体，而不会影响全局样式。

6. 深色模式：一键适配的体验

深色模式的适配在 Compose 中变得异常简单。你可以直接获取系统当前的模式：

import androidx.compose.foundation.isSystemInDarkTheme

val dark = isSystemInDarkTheme()

它会自动与系统的 UiMode 设置保持一致。如果你的应用内部还有一个深色模式开关，我的做法是把“是否深色”作为一个状态参数传入主题函数：MyAppTheme(darkTheme = appDarkMode)，这样就能完美同步了。

7. 形状与 Card：Material3 的视觉语言

Material3 为 Card、Button 等组件提供了默认的圆角样式，这些样式来源于 MaterialTheme.shapes。当然，你也可以根据需要显式地覆盖它们：

Card(shape = RoundedCornerShape(12.dp)) { /* ... */ }

8. 我的实战练习建议

如果你正在将现有项目迁移到 Compose，或者想巩固这些概念，我建议你尝试以下两个练习：

1. 主题迁移：从你现有项目的 themes.xml 中，抽出一套完整的 lightColorScheme 和 darkColorScheme，包括主色、次色等，并在 Compose Theme 中实现它。
2. 资源化：挑选应用中的任何一个界面，将其所有硬编码的中文文本，全部改为通过 stringResource 引用。

这些练习能帮你快速建立对 Compose 主题和资源系统的肌肉记忆。

好了，关于主题和资源，我的经验就先分享到这里。下一篇，我们将一起探索 Compose 中的导航与多页面管理，这是构建完整应用的关键一步。

下一篇：006-Navigation与多页面.md