Android Compose中通过单例类访问主题资源是否合理？

我正在开发首个Android Compose应用，需要验证以下访问尺寸（Dimens）、颜色（Colors）、间距等资源的方式是否正确：

我创建了如下这类类：

@Immutable
class Spacing(
    val none: Dp = 0.dp,
    val small: Dp = 5.dp,
    val medium: Dp = 10.dp,
    val large: Dp = 20.dp,
    val extraLarge: Dp = 30.dp,
    val extraLarger: Dp = 40.dp,
    val big: Dp = 100.dp,
)

还有对应FontSizing、Sizing、Colors的类。请问是否可以创建如下单例类来统一访问这些资源：

/**
 * Singleton object that contains all the theme related values to be accessed from anywhere.
 */
object AppTheme {
    val fontSizing = FontSizing()
    val spacing = Spacing()
    val color = Colors()
    val sizing = Sizing()
}

进而在Composable UI中像这样调用：

BottomSheetScaffold(
    scaffoldState = scaffoldState,
    sheetShape = RoundedCornerShape(topStart = AppTheme.spacing.large, topEnd = AppTheme.spacing.large),
    sheetPeekHeight = AppTheme.sizing.bottomSheetPeekHeight,
    sheetContent = {
        DrawSheetContent(modifier, viewState, viewModel)
    }
...

结论：这种方式可行，但存在局限性 #

你当前的实现可以正常运行，能实现统一管理资源的目的，但从Android Compose的最佳实践角度，单例方式有以下明显局限：

• 不支持主题切换：单例是全局唯一实例，初始化后资源值固定，无法动态切换深色/浅色模式、多品牌主题等需求。
• 无法跟随系统配置变化：当系统字体缩放、屏幕方向切换等配置变更时，单例不会自动重建，资源值无法同步更新。
• 不符合Compose状态管理逻辑：单例脱离了Compose的重组机制，无法利用上下文传递特性，复杂场景下扩展性差。

更推荐的实现方式：结合CompositionLocal与自定义主题 #

Compose提供的CompositionLocal机制，专门用于主题、资源这类上下文相关的全局数据传递，能完美解决上述问题，具体实现步骤如下：

1. 保留自定义资源类 #

你的Spacing、FontSizing等类可以保留，确保用@Immutable注解标记（帮助Compose优化重组）：

@Immutable
class Spacing(
    val none: Dp = 0.dp,
    val small: Dp = 5.dp,
    val medium: Dp = 10.dp,
    val large: Dp = 20.dp,
    val extraLarge: Dp = 30.dp,
    val extraLarger: Dp = 40.dp,
    val big: Dp = 100.dp,
)

// 同理定义FontSizing、Sizing、Colors类

2. 定义CompositionLocal #

为每个资源类创建对应的CompositionLocal，用于在Compose树中传递资源实例：

val LocalSpacing = compositionLocalOf { Spacing() }
val LocalFontSizing = compositionLocalOf { FontSizing() }
val LocalSizing = compositionLocalOf { Sizing() }
val LocalAppColors = compositionLocalOf { Colors() }

3. 封装自定义AppTheme #

创建顶层AppTheme Composable，将所有资源通过CompositionLocalProvider注入到Compose树中，同时结合官方MaterialTheme适配组件需求：

@Composable
fun AppTheme(
    // 允许传入自定义资源实例，支持主题切换
    spacing: Spacing = Spacing(),
    fontSizing: FontSizing = FontSizing(),
    colors: Colors = Colors(),
    sizing: Sizing = Sizing(),
    content: @Composable () -> Unit
) {
    CompositionLocalProvider(
        LocalSpacing provides spacing,
        LocalFontSizing provides fontSizing,
        LocalAppColors provides colors,
        LocalSizing provides sizing,
    ) {
        MaterialTheme(
            colorScheme = colors.toMaterialColorScheme(), // 自定义颜色映射逻辑
            typography = fontSizing.toMaterialTypography(), // 自定义排版映射逻辑
            content = content
        )
    }
}

// 示例：将自定义Colors转换为Material3的ColorScheme
fun Colors.toMaterialColorScheme(): ColorScheme {
    return ColorScheme(
        primary = this.primary,
        onPrimary = this.onPrimary,
        // 其他颜色字段映射...
    )
}

4. 在Composable中访问资源 #

通过LocalXXX.current获取资源，完全符合Compose重组机制：

@Composable
fun SomeScreen(scaffoldState: BottomSheetScaffoldState) {
    val spacing = LocalSpacing.current
    val sizing = LocalSizing.current
    
    BottomSheetScaffold(
        scaffoldState = scaffoldState,
        sheetShape = RoundedCornerShape(topStart = spacing.large, topEnd = spacing.large),
        sheetPeekHeight = sizing.bottomSheetPeekHeight,
        sheetContent = {
            DrawSheetContent(modifier, viewState, viewModel)
        }
    )
}

5. 实现主题切换 #

只需在AppTheme中传入不同资源实例即可，比如适配深色模式：

@Composable
fun AppTheme(
    darkTheme: Boolean = isSystemInDarkTheme(),
    content: @Composable () -> Unit
) {
    val colors = if (darkTheme) DarkColors() else LightColors()
    
    AppTheme(
        colors = colors,
        content = content
    )
}

总结 #

如果你的应用不需要主题切换、系统配置适配等需求，当前单例方式可以临时使用；但考虑长期维护和功能扩展，强烈建议使用CompositionLocal+自定义主题的方案，这是Compose官方推荐的资源管理方式。

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