如何让Jetpack Compose主题仅可单次自定义？

核心思路 #

要实现仅可自定义一次的主题，关键是将主题配置的控制权从MyTheme的可重复调用参数，转移到全局唯一的单例配置类中，通过标记限制初始化操作仅能执行一次，后续所有组件都读取这个单例的固定配置。

具体实现方案 #

1. 创建全局单例主题配置类 #

这个类负责存储主题的颜色、排版、尺寸配置，并通过检查标记确保仅能初始化一次：

object ThemeConfig {
    private var _colors: MyColors? = null
    private var _typography: MyTypography? = null
    private var _dimensions: MyDimensions? = null
    private var isInitialized = false

    /**
     * 仅能调用一次的主题初始化方法
     * 重复调用会抛出异常，确保自定义配置唯一
     */
    fun init(
        darkTheme: Boolean = isSystemInDarkTheme(),
        colors: MyColors = if (darkTheme) DarkColorPalette else LightColorPalette,
        typography: MyTypography = getTypography(LocalConfiguration.current),
        dimensions: MyDimensions = getDimensions(LocalConfiguration.current)
    ) {
        check(!isInitialized) { "ThemeConfig 只能初始化一次" }
        _colors = colors
        _typography = typography
        _dimensions = dimensions
        isInitialized = true
    }

    // 对外暴露只读的配置属性，确保无法直接修改
    val colors: MyColors
        get() = _colors ?: error("请先调用 ThemeConfig.init() 初始化主题配置")

    val typography: MyTypography
        get() = _typography ?: error("请先调用 ThemeConfig.init() 初始化主题配置")

    val dimensions: MyDimensions
        get() = _dimensions ?: error("请先调用 ThemeConfig.init() 初始化主题配置")
}

2. 修改MyTheme组件，移除可修改参数 #

让MyTheme直接读取单例类的固定配置，不再接受外部传入的可变参数：

@Composable
fun MyTheme(
    darkTheme: Boolean = isSystemInDarkTheme(),
    content: @Composable () -> Unit
) {
    val shapes = MaterialShapes

    // 检查主题配置是否已初始化，避免未配置就使用组件
    check(ThemeConfig.isInitialized) { "使用MyTheme前必须先初始化ThemeConfig" }

    CompositionLocalProvider(
        LocalTypography provides ThemeConfig.typography,
        LocalColors provides ThemeConfig.colors,
        LocalDimensions provides ThemeConfig.dimensions,
    ) {
        MaterialTheme(
            colors = debugColors(darkTheme),
            content = content,
            shapes = shapes
        )
    }
}

3. 在应用启动时完成主题自定义 #

在Application类的onCreate方法中执行唯一一次的主题初始化，这里可以传入自定义的配置：

class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        // 示例：自定义主色调
        val customLightColors = LightColorPalette.copy(primary = Color(0xFF2E7D32))
        // 仅执行一次的主题初始化
        ThemeConfig.init(
            colors = customLightColors,
            typography = getTypography(resources.configuration),
            dimensions = getDimensions(resources.configuration)
        )
    }
}

补充思路 #

如果项目使用依赖注入框架（如Hilt），可以将ThemeConfig封装成单例注入对象，通过DI框架的单例机制确保配置唯一，进一步简化初始化逻辑：

@Singleton
class ThemeConfig @Inject constructor(
    val colors: MyColors,
    val typography: MyTypography,
    val dimensions: MyDimensions
)

// 在Hilt模块中提供自定义配置
@Module
@InstallIn(SingletonComponent::class)
object ThemeModule {
    @Provides
    @Singleton
    fun provideMyColors(): MyColors {
        return LightColorPalette.copy(primary = Color(0xFF2E7D32))
    }

    @Provides
    @Singleton
    fun provideMyTypography(config: LocalConfiguration): MyTypography {
        return getTypography(config)
    }

    @Provides
    @Singleton
    fun provideMyDimensions(config: LocalConfiguration): MyDimensions {
        return getDimensions(config)
    }
}

这种方式下，MyTheme直接通过Hilt注入ThemeConfig，同样能保证配置仅初始化一次，且无需手动管理初始化标记。

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