应用上架Google Play Console后语言切换功能失效求助

问题根源 #

Google Play的App Bundle会自动做语言资源拆分——只给用户下发对应设备系统语言的资源包，其他语言资源直接被剥离。如果你的App是手动切换语言（不跟随系统语言），这种拆分就会导致非系统语言的strings文件根本没被下载，自然只能显示默认英语。

解决步骤 #

1. 关闭语言资源拆分 #

在Module级别的build.gradle中添加以下配置，强制Google Play将所有语言资源保留在主安装包内：

android {
    // 保留原有其他配置
    bundle {
        language {
            enableSplit = false
        }
    }
}

配置后，无论用户设备系统语言是什么，所有语言资源都会被完整安装，手动切换语言时就能正常读取对应strings文件。

2. 修正语言资源文件夹命名 #

不要使用string.kurdish、string.german这类自定义命名，必须遵循Android标准的区域代码文件夹命名规则：

• 库尔德语对应：values-ku
• 德语对应：values-de
  Android系统仅识别标准命名的资源文件夹，错误命名的资源本地测试可能临时生效，但上架后会被Play的资源处理逻辑过滤，等于白加。

3. 检查语言切换代码逻辑 #

确保你的切换代码没有依赖系统语言，而是正确修改了应用的配置，示例代码如下：

// 切换到库尔德语的示例
val targetLocale = Locale("ku")
Locale.setDefault(targetLocale)
val config = resources.configuration
config.setLocale(targetLocale)
resources.updateConfiguration(config, resources.displayMetrics)
// 重启当前页面或应用使配置生效

Android 12及以上版本建议使用AppCompatDelegate.setApplicationLocales(LocaleList(targetLocale))方法，兼容性更好，避免被系统语言强制覆盖。

4. 提前模拟Play分发环境测试 #

不要仅测试本地生成的APK，用bundletool生成与Google Play分发一致的APK包进行测试：

# 从AAB生成包含所有资源的APK集合
bundletool build-apks --bundle=app-release.aab --output=app-release.apks
# 将生成的APK安装到测试设备
bundletool install-apks --apks=app-release.apks

这样能提前排查问题，不用等上架后才发现异常。

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