在Activity.onCreate()前设置localNightMode致资源/颜色不一致问题排查

问题描述 #

我们希望在Activity创建前设置localNightMode以避免Activity重启，因此在onCreate中按以下顺序调用：

// NIGHT对应AppCompatDelegate.MODE_NIGHT_YES或其他夜间模式常量
delegate.localNightMode = NIGHT
delegate.applyDayNight()
super.onCreate(savedInstanceState)

该方案大多有效，但偶尔会出现部分资源（如1-2处文本或Drawable）仍使用日间颜色值的情况，此问题会在Activity重启（如旋转、恢复等）后修复。

若调整onCreate中的调用顺序为：

super.onCreate(savedInstanceState)
delegate.localNightMode = NIGHT
delegate.applyDayNight()

则Activity会在创建时立即重启，短暂显示日间样式后切换为夜间模式，之后所有资源显示正常。

我们尝试过调用或不调用delegate.applyDayNight()，该方法有一定帮助但无法彻底解决问题。请问可能的原因是什么？是否需要调用其他方法？

可能的原因分析 #

1. 资源加载时机不匹配
   在调用super.onCreate()前设置夜间模式，部分View可能已经在super.onCreate()内部的布局填充流程中提前完成初始化，此时夜间模式的配置还未完全同步到Context的资源系统，导致这些View缓存了日间资源。Activity重启后，所有View会基于更新后的配置重新加载资源，问题自然消失。

2. applyDayNight()的局限性
   applyDayNight()仅触发当前Context的资源配置更新，但对于已经完成初始化和资源绑定的View，它不会自动触发资源重新加载。如果View在模式切换前已经完成绘制，就会保留旧的日间样式。

3. Configuration状态同步延迟
   设置localNightMode后，系统的Configuration对象更新存在短暂延迟，而super.onCreate()会立即使用当前的Configuration加载布局，导致部分资源读取了未更新的配置参数。

解决方案 #

方案1：在attachBaseContext()中提前配置夜间模式 #

attachBaseContext()是比onCreate()更早的生命周期回调，在此处修改Context的Configuration，能确保所有View在初始化时都使用正确的夜间模式配置，且不会触发Activity重启：

override fun attachBaseContext(newBase: Context) {
    val config = newBase.resources.configuration.copy()
    // 清除原有夜间模式标记，设置为夜间模式
    config.uiMode = config.uiMode and Configuration.UI_MODE_NIGHT_MASK.inv() or Configuration.UI_MODE_NIGHT_YES
    val updatedContext = newBase.createConfigurationContext(config)
    super.attachBaseContext(updatedContext)
}

方案2：强制刷新已初始化的View（适配第一种调用顺序） #

如果坚持在onCreate()中先设置模式再调用super.onCreate()，可以在布局填充完成后，遍历所有View强制刷新资源：

override fun onCreate(savedInstanceState: Bundle?) {
    delegate.localNightMode = AppCompatDelegate.MODE_NIGHT_YES
    delegate.applyDayNight()
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)
    
    // 刷新根布局下所有View的资源
    refreshAllViews(findViewById(android.R.id.content))
}

private fun refreshAllViews(view: View) {
    when (view) {
        is TextView -> {
            // 重新读取主题颜色并设置
            view.setTextColor(view.currentTextColor)
            // 若使用了文本样式，重新应用
            view.setTextAppearance(view.context, view.textAppearance)
        }
        is ImageView -> {
            view.drawable?.let { drawable ->
                // 基于当前配置重新获取Drawable
                val newDrawable = view.context.getDrawable(drawable.resId)
                view.setImageDrawable(newDrawable)
            }
        }
        is ViewGroup -> {
            // 递归刷新子View
            for (i in 0 until view.childCount) {
                refreshAllViews(view.getChildAt(i))
            }
        }
    }
    // 强制重绘
    view.invalidate()
}

这种方式需要针对不同View类型做适配，适合需要保留原有调用顺序的场景。

方案3：禁用系统自动重启，手动处理配置变更 #

在AndroidManifest中给目标Activity添加uiMode配置变更监听，避免系统因夜间模式切换重启Activity，然后手动处理资源更新：

<activity
    android:name=".YourActivity"
    android:configChanges="uiMode">
</activity>

然后在Activity中重写配置变更回调：

override fun onConfigurationChanged(newConfig: Configuration) {
    super.onConfigurationChanged(newConfig)
    // 重新加载布局或调用refreshAllViews方法刷新资源
    setContentView(R.layout.activity_main)
}

该方案适合对页面控制要求较高的场景，但需要自行处理所有配置变更带来的资源更新逻辑。

关键注意点 #

• 确保所有资源都使用主题属性引用（如?attr/textColorPrimary）而非硬编码颜色值，否则即使模式切换，硬编码的资源也不会变化。
• 避免在super.onCreate()后调用applyDayNight()，除非可以接受短暂的日间闪屏和Activity重启。
• 单Activity的夜间模式切换优先使用localNightMode，而非全局的AppCompatDelegate.setDefaultNightMode()。

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