// 导入 Material 3 核心库
import androidx.compose.material3.*
import androidx.compose.ui.graphics.Color
// 定义种子色
val seedColor = Color(0xFF1565C0)
// 生成 Light 和 Dark 两套 ColorScheme
val lightColorScheme = lightColorScheme(
primary = Color(0xFF1565C0),
// secondary, tertiary 等由系统从 seedColor 推断
// 但也可以手动覆盖：
secondary = Color(0xFF5C6BC0)
)
val darkColorScheme = darkColorScheme(
primary = Color(0xFF82B1FF),
secondary = Color(0xFF9FA8DA)
)@Composable
fun PaymentAppTheme(
darkTheme: Boolean = isSystemInDarkTheme(),
content: @Composable () -> Unit
) {
val colorScheme = if (darkTheme) darkColorScheme else lightColorScheme
MaterialTheme(
colorScheme = colorScheme,
typography = PaymentTypography,
content = content
)
}// 伪代码示例（Kotlin）
val luminancePrimary = Color.luminance(lightColorScheme.primary)
val luminanceSurface = Color.luminance(lightColorScheme.surface)
val contrast = (max(luminancePrimary, luminanceSurface) + 0.05) /
(min(luminancePrimary, luminanceSurface) + 0.05)
Log.d("Contrast", "Primary vs Surface: $contrast")
💡 实践建议：在支付 UI 中，种子色应选择品牌蓝色或品牌紫色。不要选择纯黑/纯白或过低饱和度的颜色，否则算法生成的辅色、中性色可能丧失层次感。使用
---
#### 3.7 常见错误与避坑指南
| 错误现象 | 原因 | 解决方案 |
|----------|------|----------|
| 亮色主题下按钮文字和背景对比度不足 | Primary 和 Surface 的 Tone 值过于接近 | 检查种子色亮度，选择亮度在 20%–80% 之间的颜色；或手动提高 Primary 与 Surface 的亮度差 |
| 暗色主题下 Primary 几乎不可见 | 使用了 Light 模式下的 Tone 40 作为 Dark 模式 Primary | 确保使用 `darkColorScheme` 自动生成的 Tone 80+ 版本；不要复用 Light 的色值 |
| 第三方输入框背景色与系统状态栏混淆 | Neutral 和 NeutralVariant 色调差异小 | 在 `lightColorScheme` 中明确指定 `surfaceVariant` 和 `background` 的色值，或使用 `dynamicColorScheme` 并指定对比度保底参数 |
| 调整 Seed Color 后 UI 没有实时更新 | ColorScheme 未使用 `remember` 或 `derivedStateOf` | 将种子色定义为 `mutableStateOf` 并包装在 `MaterialTheme` 外部，通过 `derivedStateOf` 生成新的 ColorScheme |
---
lightColorScheme() 和 darkColorScheme() 时，若对特定颜色（如 error）有特殊需求，可直接覆盖传入参数，算法会保留其他自动生成的值。
📘 核心概念总结
· 动态颜色的本质是 Seed Color → HCT 算法 → Tonal Palette → Light/Dark ColorScheme。
· 同一 Tonal Palette 在 Light 模式下取低 Tone，Dark 模式下取高 Tone，保证可读性。
· 支付 UI 建议固定种子色，避免动态壁纸切换带来的品牌色混乱；但可以利用
· 调试时务必用对比度工具验证 Primary 与 Surface、OnPrimary 与 Primary 等关键组合。
---
至此，你已经掌握了 Material 3 颜色系统的核心构建策略。下一节将深入排版与间距系统的标准化配置，确保支付 UI 在各尺寸屏幕上保持统一视觉节律。
· 动态颜色的本质是 Seed Color → HCT 算法 → Tonal Palette → Light/Dark ColorScheme。
· 同一 Tonal Palette 在 Light 模式下取低 Tone，Dark 模式下取高 Tone，保证可读性。
· 支付 UI 建议固定种子色，避免动态壁纸切换带来的品牌色混乱；但可以利用
lightColorScheme 和 darkColorScheme 的自动生成节省手动配色调优时间。· 调试时务必用对比度工具验证 Primary 与 Surface、OnPrimary 与 Primary 等关键组合。