如何修改DialogFragment的windowBackground？API34修改失效问题排查

API 32 到 API 34 的关键变更 #

从Android 12L（API32）到Android 14（API34），Dialog/DialogFragment的背景处理逻辑有以下核心变化：

• Material3主题样式优先级提升：API34中，若应用采用Material3主题，Dialog的背景默认由主题的android:dialogBackground或materialAlertDialogBackground属性控制，系统会在Dialog初始化后期应用这些样式，覆盖开发者早期生命周期中手动设置的windowBackground，而API32无此强制覆盖逻辑。
• Window属性设置时机限制：API34调整了Window属性的应用流程，若在onCreateDialog()或onCreateView()中设置windowBackground，会被后续系统主题初始化步骤覆盖，API32中则不会出现这种情况。
• Dialog布局层级优化：API34新增了Dialog的容器布局层，直接设置Window背景可能被上层布局的默认背景遮挡，而API32的Dialog布局层级更简单，设置Window背景可直接生效。

解决办法 #

方式1：通过主题属性指定背景 #

在自定义Dialog主题中设置背景属性，让系统直接应用该样式：

<!-- 普通DialogFragment使用的主题 -->
<style name="CustomDialogTheme" parent="Theme.Material3.Dialog">
    <item name="android:dialogBackground">@color/grey</item>
</style>

<!-- MaterialAlertDialogFragment使用的主题 -->
<style name="CustomAlertDialogTheme" parent="Theme.Material3.AlertDialog">
    <item name="materialAlertDialogBackground">@color/grey</item>
</style>

在DialogFragment中指定主题：

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setStyle(STYLE_NORMAL, R.style.CustomDialogTheme)
}

方式2：在正确生命周期设置背景 #

选择onStart()生命周期方法设置Window背景，此时系统主题初始化已完成，设置不会被覆盖：

override fun onStart() {
    super.onStart()
    dialog?.window?.run {
        // 清除默认背景后设置自定义灰色背景
        setBackgroundDrawable(ColorDrawable(Color.GRAY))
        // 可选：按需调整窗口尺寸
        setLayoutParams(WindowManager.LayoutParams().apply {
            width = ViewGroup.LayoutParams.MATCH_PARENT
            height = ViewGroup.LayoutParams.WRAP_CONTENT
            copyFrom(window.attributes)
        })
    }
}

方式3：禁用默认Dialog背景后自定义 #

若需要完全自定义背景，可先将主题中的默认Dialog背景设为透明，再手动设置：

<style name="TransparentDialogTheme" parent="Theme.Material3.Dialog">
    <item name="android:dialogBackground">@android:color/transparent</item>
</style>

然后在onStart()中设置自定义背景Drawable即可。

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