Compose Multiplatform是否有主动切换语言的官方API？及解决方案咨询

目前 Compose Multiplatform 没有官方提供直接主动切换语言的 API，但可以通过自定义 CompositionLocal + 状态管理的方式实现该功能，以下是具体实现步骤：

1. 管理语言状态 #

先定义一个状态持有者（比如 ViewModel 或单例 StateFlow），用来保存当前选中的语言标识（如 "zh"、"en"）：

class LanguageViewModel : ViewModel() {
    private val _currentLocale = MutableStateFlow(Locale.getDefault())
    val currentLocale = _currentLocale.asStateFlow()

    fun switchLanguage(locale: Locale) {
        _currentLocale.value = locale
    }
}

2. 自定义 CompositionLocal #

创建一个自定义的 CompositionLocal，用来向整个 Composables 树提供当前应用使用的 Locale：

val LocalAppLocale = compositionLocalOf<Locale> { Locale.getDefault() }

3. 替代默认资源获取函数 #

自定义资源加载函数，取代默认的 stringResource()，根据当前 LocalAppLocale 加载对应语言的资源：

Android 平台实现 #

@Composable
fun appStringResource(id: Int): String {
    val locale = LocalAppLocale.current
    val context = LocalContext.current
    val configuration = Configuration(context.resources.configuration).apply {
        setLocale(locale)
    }
    // 创建适配当前语言的资源对象
    val resources = context.createConfigurationContext(configuration).resources
    return resources.getString(id)
}

Desktop 平台实现 #

Desktop 无系统 Context，可通过加载多语言 Properties 文件实现：

// 资源管理工具类
object ResourceManager {
    private val resourceCache = mutableMapOf<String, Map<String, String>>()

    init {
        // 预加载所有语言的资源文件
        resourceCache["en"] = loadProperties("strings_en.properties")
        resourceCache["zh"] = loadProperties("strings_zh.properties")
    }

    private fun loadProperties(fileName: String): Map<String, String> {
        val inputStream = javaClass.getResourceAsStream("/$fileName")
            ?: throw IllegalArgumentException("资源文件 $fileName 未找到")
        return Properties().apply { load(inputStream) }.entries.associate {
            it.key.toString() to it.value.toString()
        }
    }

    fun getString(key: String, locale: String): String {
        return resourceCache[locale]?.get(key) ?: resourceCache["en"]?.get(key) ?: key
    }
}

// 自定义Composable资源函数
@Composable
fun appStringResource(key: String): String {
    val locale = LocalAppLocale.current
    return ResourceManager.getString(key, locale.language)
}

4. 注入全局语言状态 #

在应用根节点通过 CompositionLocalProvider 注入当前语言状态，确保所有子 Composable 都能获取到：

@Composable
fun MyApp() {
    val languageViewModel = viewModel<LanguageViewModel>()
    val currentLocale by languageViewModel.currentLocale.collectAsState()

    CompositionLocalProvider(LocalAppLocale provides currentLocale) {
        // 应用内所有页面使用 appStringResource() 替代默认函数
        MainScreen(
            onSwitchLanguage = { locale ->
                languageViewModel.switchLanguage(locale)
            }
        )
    }
}

5. 处理语言切换触发重组 #

当用户选择新语言时，调用 switchLanguage() 更新状态，Compose 会自动触发依赖 LocalAppLocale 的 Composable 重组，加载对应语言的资源。

额外注意（Android） #

若要避免系统语言变更覆盖应用内设置，可在 Activity 中重写配置变更方法：

override fun onConfigurationChanged(newConfig: Configuration) {
    super.onConfigurationChanged(newConfig)
    // 保持应用内语言设置，忽略系统变更
    val viewModel = viewModel<LanguageViewModel>()
    viewModel.currentLocale.value.let { locale ->
        val config = Configuration(newConfig).apply { setLocale(locale) }
        resources.updateConfiguration(config, resources.displayMetrics)
    }
}

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