API33 Compose项目中AppCompatDelegate.setApplicationLocales失效问题

问题本质 #

使用ComponentActivity而非AppCompatActivity时，AppCompatDelegate不会自动为Activity创建对应的Delegate实例，导致getLocaleManagerForApplication方法遍历sActivityDelegates时找不到有效上下文，最终无法初始化LocaleManager，调用setApplicationLocales自然没有效果。

解决方案 #

方法1：直接使用Android 13+原生LocaleManager API（推荐） #

因为项目Target API是33，完全可以绕过AppCompat的兼容层，直接调用系统原生API设置应用语言：

• 获取LocaleManager实例：

val localeManager = applicationContext.getSystemService(LocaleManager::class.java)

• 构建目标语言环境：

// 示例：设置简体中文
val targetLocale = Locale("zh", "CN")
val appLocales = LocaleList.forLanguageTags(targetLocale.toLanguageTag())

• 应用语言设置：

localeManager.applicationLocales = appLocales

• 重启Activity生效：

startActivity(Intent(this, MainActivity::class.java).apply {
    addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP or Intent.FLAG_ACTIVITY_NEW_TASK)
})
finish()

方法2：手动在ComponentActivity中初始化AppCompatDelegate #

如果一定要用AppCompatDelegate的方法，手动创建Delegate实例让它被加入sActivityDelegates即可：

1. 在ComponentActivity中添加成员变量：

private lateinit var appCompatDelegate: AppCompatDelegate

2. 在onCreate中初始化：

override fun onCreate(savedInstanceState: Bundle?) {
    appCompatDelegate = AppCompatDelegate.create(this, null)
    appCompatDelegate.installViewFactory()
    super.onCreate(savedInstanceState)
    // 后续的Compose setContent等代码
}

3. 之后正常调用AppCompatDelegate.setApplicationLocales(appLocale)，再重启Activity即可生效。

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