当前位置：首页 > ds >正文

Jetpack Compose 中更新应用语言

ds 2025/8/30 1:59:29

在 Jetpack Compose 应用中更新语言需要结合传统的 Android 语言配置方法和 Compose 的重组机制。以下是完整的实现方案：

1. 创建语言管理类

object LocaleManager {private var currentLocale: Locale = Locale.getDefault()fun setLocale(context: Context, locale: Locale) {currentLocale = localeupdateResources(context, locale)persistLocale(context, locale)}fun getCurrentLocale(): Locale = currentLocaleprivate fun updateResources(context: Context, locale: Locale) {Locale.setDefault(locale)val resources = context.resourcesval configuration = Configuration(resources.configuration)if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {configuration.setLocale(locale)context.createConfigurationContext(configuration)} else {@Suppress("DEPRECATION")configuration.locale = localeresources.updateConfiguration(configuration, resources.displayMetrics)}}private fun persistLocale(context: Context, locale: Locale) {context.getSharedPreferences("AppPreferences", Context.MODE_PRIVATE).edit().putString("app_language", locale.language).apply()}fun getPersistedLocale(context: Context): Locale {val prefs = context.getSharedPreferences("AppPreferences", Context.MODE_PRIVATE)val lang = prefs.getString("app_language", Locale.getDefault().language) ?: Locale.getDefault().languagereturn Locale(lang)}
}

2. 创建可组合函数管理语言状态

@Composable
fun rememberLocaleState(context: Context): State<Locale> {val localeState = remember { mutableStateOf(LocaleManager.getPersistedLocale(context)) }DisposableEffect(Unit) {val listener = SharedPreferences.OnSharedPreferenceChangeListener { _, key ->if (key == "app_language") {localeState.value = LocaleManager.getPersistedLocale(context)}}val prefs = context.getSharedPreferences("AppPreferences", Context.MODE_PRIVATE)prefs.registerOnSharedPreferenceChangeListener(listener)onDispose {prefs.unregisterOnSharedPreferenceChangeListener(listener)}}return localeState
}

3. 创建自定义 Activity

abstract class LocaleAwareComponentActivity : ComponentActivity() {override fun attachBaseContext(newBase: Context) {super.attachBaseContext(newBase.wrapWithLocale(LocaleManager.getPersistedLocale(newBase)))}private fun Context.wrapWithLocale(locale: Locale): Context {val configuration = Configuration(resources.configuration)return if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {configuration.setLocale(locale)createConfigurationContext(configuration)} else {@Suppress("DEPRECATION")configuration.locale = localeresources.updateConfiguration(configuration, resources.displayMetrics)this}}
}

4. 在应用中使用

MainActivity.kt

class MainActivity : LocaleAwareComponentActivity() {override fun onCreate(savedInstanceState: Bundle?) {super.onCreate(savedInstanceState)setContent {val localeState = rememberLocaleState(this)// 使用DisposableEffect确保语言变更时更新ActivityDisposableEffect(localeState.value) {onDispose { }}YourAppTheme(locale = localeState.value) {AppContent(localeState)}}}
}

主题设置

@Composable
fun YourAppTheme(locale: Locale = LocaleManager.getCurrentLocale(),content: @Composable () -> Unit
) {val context = LocalContext.currentCompositionLocalProvider(LocalContext provides context.wrapWithLocale(locale),content = content)
}private fun Context.wrapWithLocale(locale: Locale): Context {val configuration = Configuration(resources.configuration)return if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {configuration.setLocale(locale)createConfigurationContext(configuration)} else {@Suppress("DEPRECATION")configuration.locale = localeresources.updateConfiguration(configuration, resources.displayMetrics)this}
}

语言切换界面

@Composable
fun LanguageSwitcher(localeState: State<Locale>) {val context = LocalContext.currentColumn {val currentLocale = localeState.valueText("Current language: ${currentLocale.displayLanguage}")Button(onClick = { LocaleManager.setLocale(context, Locale("en"))(context as? Activity)?.recreate()}) {Text("English")}Button(onClick = { LocaleManager.setLocale(context, Locale("es"))(context as? Activity)?.recreate()}) {Text("Español")}Button(onClick = { LocaleManager.setLocale(context, Locale("fr"))(context as? Activity)?.recreate()}) {Text("Français")}}
}

5. 完整应用结构示例

@Composable
fun AppContent(localeState: State<Locale>) {val context = LocalContext.currentScaffold(topBar = { TopAppBar(title = { Text(stringResource(R.string.app_name)) }) },content = { padding ->Column(modifier = Modifier.padding(padding)) {LanguageSwitcher(localeState)// 示例文本，会随语言变化Text(stringResource(R.string.hello_world))}})
}