Android应用Locale切换本地运行正常 Play商店发布版失效求助

1. 首要排查点：Google Play App Bundle 语言资源拆分限制 #

你本地打包的APK包含全量语言资源，但如果发布到Play商店时用的是AAB（Android App Bundle）格式提交，Play默认会开启按语言拆分资源功能：用户安装应用时，只会下载和系统当前语言匹配的语言资源，其他语言的资源不会被下载到本地，切换Locale时找不到对应资源就会 fallback 到默认语言，看起来就像切换失效。

解决方案： #

在Module级别的build.gradle的android块中添加配置，禁用语言资源拆分，强制打包所有语言资源：

android {
    bundle {
        language {
            enableSplit = false
        }
    }
}

该配置会让Play分发时，无论用户系统语言是什么，都把所有语言资源打包到安装包中，切换时即可正常加载。

2. 代码逻辑修正 #

你当前的setAppLocale方法中调用了context.createConfigurationContext(config)，但没有使用返回的Context实例，这个调用完全无效；且Android 12及以上版本中，单独调用updateConfiguration已经被废弃，不保证生效，需要修正Context替换逻辑。

解决方案： #

所有Activity重写attachBaseContext方法，在Context绑定阶段就应用自定义Locale：

@Override
protected void attachBaseContext(Context newBase) {
    // 从SharedPreferences读取已保存的语言
    SharedPreferences sharedPref = newBase.getSharedPreferences("AppGlobalConfig", Context.MODE_PRIVATE);
    String lang = sharedPref.getString("Test.SL.LanguageName", "English");
    String targetLang = lang.equals("Sinhala") ? "si" : "en";
    
    Locale locale = new Locale(targetLang);
    Locale.setDefault(locale);
    Configuration config = newBase.getResources().getConfiguration();
    config.setLocale(locale);
    Context context = newBase.createConfigurationContext(config);
    super.attachBaseContext(context);
}

同时可以删掉setAppLocale方法中context.createConfigurationContext(config)这行无效代码，也不需要重复在onCreate中调用setAppLocale。

3. SharedPreferences存储范围问题 #

你当前在MainActivity中调用getPreferences(Context.MODE_PRIVATE)获取的是MainActivity私有的SharedPreferences，如果SettingsFragment中保存语言配置时，用的是所在页面的Activity级SP，两边读取的SP不是同一个，就会导致MainActivity读不到正确的保存语言，始终用默认值。

解决方案： #

统一使用Application级别的SharedPreferences存取配置，不要用Activity级别的getPreferences：

// 存、读配置时都用该方式获取SP实例
SharedPreferences sharedPref = context.getSharedPreferences("AppGlobalConfig", Context.MODE_PRIVATE);

确保所有组件存取的都是同一个SP文件，不会出现配置读取失效问题。

4. 其他排查点 #

检查你的ProGuard/R8混淆规则，有没有误删语言相关的资源类，可添加如下规则防止资源被混淆：

-keep class * extends android.content.res.Resources { *; }
-keep class android.content.res.Configuration { *; }

如果你的目标SDK是Android 13（API 33）及以上，可直接适配系统级应用语言偏好，调用系统API设置应用语言，不需要自己维护SP和重启逻辑，兼容性更好。

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