Android API 24+应用LocaleHelper多语言切换仅部分生效求助

算力阿峰

2026-10-6

故障原因

核心诱因：发布包格式从APK切换为Android App Bundle（AAB）后，Google Play默认开启按语言拆分资源的优化策略，仅会为用户下载其设备系统语言列表内包含的语言资源，其余未预装的语言资源不会被下载，应用内切换时找不到对应资源就会直接 fallback 到英文。你提到的可正常切换的3种语言，恰好是测试设备系统预装的语言。
代码缺陷：updateResources方法中创建Locale仅传入语言码，未适配带地区后缀的语言场景，若你的部分语言资源带区域标识（如values-pt-rBR、values-zh-rTW），仅用语言码生成的Locale无法匹配到对应资源，也会返回默认英文内容。
隐藏问题：仅处理了Activity和Application的attachBaseContext回调，未同步更新应用运行时的全局ApplicationContext的Locale配置，部分使用ApplicationContext加载资源的场景仍会读取旧语言内容。

修复方案

禁用AAB语言资源拆分：在app模块的build.gradle中添加如下配置，强制打包所有语言资源，避免拆分导致的资源缺失：

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

优化Locale创建逻辑，兼容带地区的语言：修改updateResources方法，适配带分隔符的语言码，同时补充资源更新逻辑适配API 24+：

private static Context updateResources(Context context, String language) {
    Locale locale;
    // 适配带地区的语言码，例如pt-BR、zh-CN
    if (language.contains("-")) {
        String[] langParts = language.split("-");
        locale = new Locale(langParts[0], langParts[1]);
    } else {
        locale = new Locale(language);
    }
    Locale.setDefault(locale);

    Configuration configuration = context.getResources().getConfiguration();
    configuration.setLocale(locale);
    configuration.setLayoutDirection(locale);
    // 同步更新资源配置，避免部分场景读取缓存的旧资源
    context.getResources().updateConfiguration(configuration, context.getResources().getDisplayMetrics());

    return context.createConfigurationContext(configuration);
}

应用内切换语言时同步更新全局上下文：切换语言的操作执行后，同步更新Application的Locale配置，再重启首页生效：

// 切换语言时执行
LocaleHelper.setLocale(getApplicationContext(), targetLangCode);
// 清空回退栈重启首页，确保所有界面刷新为目标语言
Intent intent = new Intent(this, MainActivity.class);
intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_CLEAR_TASK);
startActivity(intent);

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