2023年Android应用程序化修改Locale的有效方案咨询

你的代码存在几个关键问题：未持久化语言偏好、使用了Android N+已废弃的API、未适配高版本系统的Locale设置逻辑，导致修改后无法稳定生效。以下是经过验证的正确实现方案：

1. 实现LocaleHelper（含偏好持久化） #

这个工具类负责保存用户选择的语言、读取系统默认语言，并适配不同Android版本的Locale配置逻辑：

object LocaleHelper {
    private const val PREF_LANG_KEY = "selected_language"
    private const val PREF_NAME = "app_locale_prefs"

    // 设置并保存目标语言，返回更新后的Context
    fun setLocale(context: Context, language: String): Context {
        saveLanguagePreference(context, language)
        return updateResources(context, language)
    }

    // 获取已适配Locale的Context（用于attachBaseContext）
    fun getUpdatedContext(context: Context): Context {
        val targetLang = getSavedLanguage(context) ?: Locale.getDefault().language
        return updateResources(context, targetLang)
    }

    // 保存语言到SharedPreferences
    private fun saveLanguagePreference(context: Context, language: String) {
        context.getSharedPreferences(PREF_NAME, Context.MODE_PRIVATE)
            .edit()
            .putString(PREF_LANG_KEY, language)
            .apply()
    }

    // 读取已保存的语言
    private fun getSavedLanguage(context: Context): String? {
        return context.getSharedPreferences(PREF_NAME, Context.MODE_PRIVATE)
            .getString(PREF_LANG_KEY, null)
    }

    // 核心：根据目标语言更新Context配置
    private fun updateResources(context: Context, language: String): Context {
        val targetLocale = Locale(language)
        Locale.setDefault(targetLocale)

        val resources = context.resources
        val config = Configuration(resources.configuration)

        // 适配不同Android版本的Locale设置API
        when {
            Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU -> {
                config.setLocales(LocaleList(targetLocale))
            }
            Build.VERSION.SDK_INT >= Build.VERSION_CODES.N -> {
                config.setLocales(LocaleList(targetLocale))
            }
            else -> {
                config.locale = targetLocale
            }
        }
        // 适配布局方向（RTL/LTR）
        config.setLayoutDirection(targetLocale)

        return if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
            context.createConfigurationContext(config)
        } else {
            resources.updateConfiguration(config, resources.displayMetrics)
            context
        }
    }
}

2. 在Activity中应用Locale #

所有Activity都需要重写attachBaseContext方法，确保启动时自动应用已保存的Locale。推荐使用BaseActivity统一处理：

abstract class BaseActivity : AppCompatActivity() {
    override fun attachBaseContext(newBase: Context) {
        // 替换为已适配Locale的Context
        val updatedContext = LocaleHelper.getUpdatedContext(newBase)
        super.attachBaseContext(updatedContext)
    }
}

如果不想使用BaseActivity，每个Activity单独实现：

override fun attachBaseContext(newBase: Context) {
    super.attachBaseContext(LocaleHelper.getUpdatedContext(newBase))
}

3. 触发语言切换 #

当用户选择目标语言（比如哈萨克语"kk"）时，调用以下代码：

// 设置并保存语言
LocaleHelper.setLocale(this, "kk")
// 重建Activity使配置生效
ActivityCompat.recreate(this)

关键注意事项 #

• 资源文件命名：确保翻译资源放在正确的目录，比如哈萨克语资源需放在res/values-kk/strings.xml
• 全Activity覆盖：所有Activity都必须继承BaseActivity或重写attachBaseContext，否则新启动的Activity会恢复系统语言
• 高版本适配：Android 7.0（API24）及以上必须使用setLocales替代废弃的setLocale，LocaleList是系统要求的标准格式
• 布局方向适配：调用setLayoutDirection确保RTL语言（如阿拉伯语、希伯来语）的布局方向正确
• 持久化保障：通过SharedPreferences保存语言偏好，确保应用重启后依然保留用户选择的语言

内容的提问来源于stack exchange，提问作者Славик Колисниченкo