Android字符串回退逻辑在不同Locale下表现异常问题排查

问题现象 #

应用已支持en、en-AU、en-CA、en-TH、en-US多语言本地化，某字符串仅存在于default、en-AU、en-TH的strings.xml中：

• 切换至en-US Locale时，字符串从default读取（符合预期）
• 切换至en-CA Locale时，Android 10/11/12读取en-AU的字符串，Android 13读取en-TH的字符串（不符合预期，预期应读取default资源）
• 若所有strings.xml都包含该字符串，各Locale可正常读取对应内容
  已在新项目中复现该问题，当前Locale设置代码：

val conf: Configuration = res.configuration
conf.locale = Locale("en","US") //CA for canada
res.updateConfiguration(conf, res.displayMetrics)

问题原因 #

Android的资源匹配逻辑中，当目标Locale无对应资源时，会按语言区域的优先级规则查找最接近的同语言变体（如en-CA属于en语言系，会优先匹配其他en-*变体资源），而非直接 fallback 到default资源。不同Android版本对区域匹配的优先级排序存在差异，导致en-CA在不同版本匹配到了不同的en变体资源。

解决方案 #

方案1：自定义资源Fallback逻辑 #

通过ContextWrapper重写资源查找方法，当目标Locale无对应资源时，直接读取default资源：

class CustomContextWrapper(base: Context) : ContextWrapper(base) {
    companion object {
        fun wrap(context: Context, targetLocale: Locale): ContextWrapper {
            val configuration = Configuration(context.resources.configuration).apply {
                setLocale(targetLocale)
            }
            val newContext = context.createConfigurationContext(configuration)
            
            return object : ContextWrapper(newContext) {
                override fun getResources(): Resources {
                    return object : super.getResources() {
                        override fun getText(id: Int): CharSequence {
                            return try {
                                super.getText(id)
                            } catch (_: Resources.NotFoundException) {
                                context.resources.getText(id)
                            }
                        }

                        override fun getString(id: Int): String {
                            return try {
                                super.getString(id)
                            } catch (_: Resources.NotFoundException) {
                                context.resources.getString(id)
                            }
                        }

                        // 按需重写其他资源获取方法（如getQuantityString等）
                    }
                }
            }
        }
    }
}

在Activity中替换Context：

override fun attachBaseContext(newBase: Context) {
    val targetLocale = Locale("en", "CA")
    super.attachBaseContext(CustomContextWrapper.wrap(newBase, targetLocale))
}

方案2：为en-CA创建占位资源文件 #

在res/values-en-rCA/目录下创建strings.xml，对缺失的字符串直接引用default资源：

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <!-- 仅定义缺失的字符串，指向default资源 -->
    <string name="your_missing_string">@string/your_missing_string</string>
</resources>

此方法让Android优先读取en-CA的资源，而该资源直接复用default内容，符合预期。

方案3：使用Androidx LocaleManager（推荐） #

借助Androidx的LocaleManager统一管理Locale，避免版本差异导致的匹配问题：

1. 在AndroidManifest.xml的<application>标签添加配置：

android:localeConfig="@xml/locale_config"

2. 创建res/xml/locale_config.xml定义支持的Locale：

<?xml version="1.0" encoding="utf-8"?>
<locale-config xmlns:android="http://schemas.android.com/apk/res/android">
    <locale android:name="en"/>
    <locale android:name="en-AU"/>
    <locale android:name="en-CA"/>
    <locale android:name="en-TH"/>
    <locale android:name="en-US"/>
</locale-config>

3. 设置Locale：

val localeManager = LocaleManager.getApplicationLocaleManager(applicationContext)
localeManager.setApplicationLocales(LocalesListCompat.forLanguageTags("en-CA"))

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