Kotlin开发的Android应用Locale设置语言在Play Store包中失效问题

1. 禁用Google Play的语言资源拆分 #

上传App Bundle到Google Play时，默认会启用语言资源拆分——Google仅向用户分发其系统语言对应的资源包，导致切换到其他语言时，应用找不到对应strings资源，功能失效。

解决方法：在模块级build.gradle（或build.gradle.kts）中添加配置，禁用语言拆分：

android {
    // ...其他配置
    bundle {
        language {
            enableSplit = false
        }
    }
}

配置后生成的App Bundle会包含所有语言资源，用户切换语言时可正常加载对应资源。

2. 适配Android版本的语言设置API #

你的代码仅适配旧版本Android，API 24+及更高版本需要更新配置逻辑，且必须使用ApplicationContext避免上下文失效：

修改LanguageManager代码：

class LanguageManager(private val context: Context) {
    private val prefs = context.getSharedPreferences("AppSettings", Context.MODE_PRIVATE)
    private val LANG_KEY = "selected_language"

    // 保存用户选择的语言
    fun saveLanguage(languageCode: String) {
        prefs.edit().putString(LANG_KEY, languageCode).apply()
    }

    // 获取保存的语言，默认用系统语言
    fun getSavedLanguage(): String {
        return prefs.getString(LANG_KEY, Locale.getDefault().language) ?: "en"
    }

    fun setAppLanguage(languageCode: String) {
        val locale = Locale(languageCode)
        Locale.setDefault(locale)

        val resources = context.applicationContext.resources
        val configuration = resources.configuration

        // 适配不同Android版本
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
            configuration.setLocale(locale)
            configuration.setLocales(LocaleList(locale))
        } else {
            configuration.setLocale(locale)
        }

        resources.updateConfiguration(configuration, resources.displayMetrics)
        // 保存语言设置
        saveLanguage(languageCode)
    }
}

3. 在Application类中初始化语言设置 #

需在应用启动时就应用保存的语言设置，否则Activity启动后才设置会导致界面闪烁或失效：

创建自定义Application类：

class MyApp : Application() {
    override fun onCreate() {
        super.onCreate()
        val languageManager = LanguageManager(this)
        val savedLang = languageManager.getSavedLanguage()
        languageManager.setAppLanguage(savedLang)
    }
}

在AndroidManifest.xml中注册该Application：

<application
    android:name=".MyApp"
    <!-- 其他配置 -->
    >

4. 切换语言后重启Activity #

在Fragment中调用setAppLanguage后，需重启当前Activity使设置生效：

languageManager = LanguageManager(requireContext())
languageManager.setAppLanguage(language)
// 重启Activity
requireActivity().finish()
requireActivity().startActivity(requireActivity().intent)

额外注意事项 #

• 确保res目录下有对应语言的资源文件夹，比如values-es（西班牙语）、values-zh-rCN（简体中文）等，且包含完整的strings.xml文件。
• 测试签名包时，需生成签名APK/App Bundle后手动安装到设备，避免开发环境的特殊处理影响测试结果。

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