切换系统主题时避免Fragment重建的技术求助

核心思路 #

直接添加android:configChanges="uiMode"会阻断系统自动重启Activity应用主题，所以需要手动处理配置变化+手动应用主题，既避免Fragment重建，又能跟上系统主题切换，同时兼容手动快捷切换。

步骤1：配置Manifest保留uiMode监听 #

在Activity的Manifest配置中保留android:configChanges="uiMode"，阻止系统因主题切换重启Activity：

<activity
    android:name=".YourMainActivity"
    android:configChanges="uiMode"
    android:theme="@style/Theme.Material3.Light.NoActionBar">
    <!-- 其他配置 -->
</activity>

步骤2：在Activity中手动响应配置变化 #

重写onConfigurationChanged方法，在系统主题切换时手动更新主题，同时刷新所有Fragment的UI：

override fun onConfigurationChanged(newConfig: Configuration) {
    super.onConfigurationChanged(newConfig)
    // 重新应用当前主题
    refreshAppTheme()
    // 通知所有Fragment更新UI
    supportFragmentManager.fragments.forEach { fragment ->
        fragment.view?.let { view ->
            // 手动刷新Fragment视图的主题关联属性
            view.refreshDrawableState()
            // 若有自定义控件，可在此触发样式更新
        }
    }
}

private fun refreshAppTheme() {
    val nightMode = AppCompatDelegate.getDefaultNightMode()
    // 根据当前模式设置对应主题
    when (nightMode) {
        AppCompatDelegate.MODE_NIGHT_YES -> setTheme(R.style.Theme_Material3_Dark_NoActionBar)
        AppCompatDelegate.MODE_NIGHT_NO -> setTheme(R.style.Theme_Material3_Light_NoActionBar)
        AppCompatDelegate.MODE_NIGHT_FOLLOW_SYSTEM -> {
            val currentNightMode = resources.configuration.uiMode and Configuration.UI_MODE_NIGHT_MASK
            setTheme(
                if (currentNightMode == Configuration.UI_MODE_NIGHT_YES)
                    R.style.Theme_Material3_Dark_NoActionBar
                else
                    R.style.Theme_Material3_Light_NoActionBar
            )
        }
    }
    // 刷新Activity根视图样式
    window.decorView.setBackgroundColor(ContextCompat.getColor(this, android.R.color.background_light))
}

步骤3：处理手动快捷主题切换 #

手动切换主题时，直接设置AppCompatDelegate的NightMode，再调用主题刷新方法即可，无需重启Activity：

// 切换到夜间模式
fun switchToDarkMode() {
    AppCompatDelegate.setDefaultNightMode(AppCompatDelegate.MODE_NIGHT_YES)
    refreshAppTheme()
}

// 切换到日间模式
fun switchToLightMode() {
    AppCompatDelegate.setDefaultNightMode(AppCompatDelegate.MODE_NIGHT_NO)
    refreshAppTheme()
}

// 跟随系统主题
fun followSystemTheme() {
    AppCompatDelegate.setDefaultNightMode(AppCompatDelegate.MODE_NIGHT_FOLLOW_SYSTEM)
    refreshAppTheme()
}

注意事项 #

• Fragment中通过主题属性（如?attr/colorSurface）设置的UI元素，需调用view?.refreshDrawableState()触发样式更新。
• 避免在Fragment中持有静态引用，防止因Fragment生命周期延长导致内存泄漏。

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