Android应用Debug版多语言正常，Release版仅支持英西语问题求助

问题描述 #

Android应用配置了英语（默认）、西班牙语、德语、法语、日语、俄语6种语言资源：

• Debug模式（模拟器/真机）下语言切换完全正常；
• 打包签名App Bundle上传Play商店后，内部测试版本仅英语、西班牙语可正常切换，其余语言切换后Locale已成功修改，但界面仍回退显示英语。

核心原因 #

Play App Bundle的语言资源自动拆分（Split APK）机制：
Play商店会根据用户设备的系统语言偏好，只下载对应语言的资源APK。如果用户设备的系统语言列表中没有德语、法语、日语、俄语，这些语言的资源包不会被下载到设备中，导致切换语言时无法找到对应资源，只能 fallback到默认的英语。而西班牙语能生效，大概率是因为用户设备的系统语言包含西班牙语，对应的资源包被自动下载了。

解决方案 #

1. 禁用语言资源拆分（推荐） #

在模块级build.gradle（或build.gradle.kts）中添加配置，强制将所有语言资源打包进主APK，避免Play商店自动拆分：

android {
    // ...其他配置
    bundle {
        language {
            // 禁用语言资源拆分，所有语言资源都包含在主APK中
            enableSplit = false
        }
    }
}

注意：配合已配置的resConfigs "en", "de", "es", "fr", "ja", "ru"，该配置会确保指定的所有语言资源都被保留并打包，不会被拆分。

2. 验证资源打包完整性 #

生成App Bundle后，使用bundletool生成通用APK（包含所有资源），安装到设备测试，确认所有语言切换正常：

bundletool build-apks --bundle=your-app-bundle.aab --output=your-app.apks --mode=universal

提取并安装通用APK：

unzip your-app.apks -d output-dir
adb install output-dir/universal.apk

如果通用APK测试正常，即可确认问题源于Play商店的资源拆分机制。

3. 优化Locale设置代码（可选） #

虽然Debug模式正常，但为提升兼容性，部分语言建议携带地区代码（不影响核心问题，但避免潜在适配问题）：

// 德语带地区代码示例
Locale deLocale = new Locale("de", "DE");
// 日语带地区代码示例
Locale jaLocale = new Locale("ja", "JP");

4. 检查Play商店发布配置 #

在Play控制台发布App Bundle时，确认没有手动排除相关语言的资源下载，保持默认配置即可（禁用拆分后该配置不影响）。

补充说明 #

• 禁用语言资源拆分会略微增大APK体积，但对于仅6种语言的应用来说，体积增加在可接受范围内；
• 如果需要保留资源拆分机制，可引导用户在系统设置中添加目标语言，Play商店会自动下载对应的资源包，但这种方式对用户不友好，不推荐。

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