Android全屏AlertDialog无法延伸至状态栏（仅部分设备复现）

问题表现 #

在Android应用中实现全屏对话框时，状态栏区域出现无法被对话框背景覆盖的灰色条，该问题仅在部分搭载定制ROM的设备上复现，AOSP原生系统无异常。

核心原因 #

该问题并非Android原生组件缺陷，是不同厂商对Dialog类型窗口的系统UI默认策略差异导致：

• 部分国产定制ROM（MIUI、旧版ColorOS、HarmonyOS早期版本）会对非Activity类型的Dialog窗口强制预留状态栏高度的占位
• 原有样式中错误使用android:windowFullscreen="true"属性，触发系统全屏兼容逻辑，自动给状态栏区域加半透明灰蒙层
• 未主动配置窗口允许内容延伸到系统栏区域，被系统默认的fitsSystemWindows规则缩进

修复步骤 #

1. 修正对话框主题样式 #

替换原有FullscreenDialogStyle配置，使用匹配Material组件的父主题，移除会触发兼容问题的属性：

<style name="FullscreenDialogStyle" parent="Theme.MaterialComponents.Light.Dialog.Alert">
    <item name="android:windowBackground">@color/primary</item>
    <item name="android:navigationBarColor">@color/primary</item>
    <item name="android:statusBarColor">@color/primary</item>
    <item name="android:windowNoTitle">true</item>
    <item name="android:windowIsFloating">false</item>
    <!-- 关闭系统默认的内容缩进 -->
    <item name="android:fitsSystemWindows">false</item>
    <!-- 适配挖孔屏区域，允许内容延伸到挖孔位置 -->
    <item name="android:windowLayoutInDisplayCutoutMode" tools:targetApi="p">shortEdges</item>
</style>

注意：必须移除原有样式中android:windowFullscreen="true"配置，该属性仅适用于Activity全屏场景，在Dialog窗口上启用会直接触发大部分定制ROM的灰条兼容逻辑。

2. 代码中强制覆盖窗口默认参数 #

Builder的背景缩进配置优先级低于系统窗口默认规则，需要在对话框show之后拿到Window对象，手动设置全屏布局参数，针对特殊机型加适配逻辑：

val builder = MaterialAlertDialogBuilder(this, R.style.FullscreenDialogStyle)
val binding = DialogSuccessBinding.inflate(layoutInflater)
binding.SuccessDialogMessage.text = getString(R.string.AddGuestCard_Success)
builder.setView(binding.root)
builder.background = ColorDrawable(getColor(R.color.primary))
builder.setBackgroundInsetBottom(0)
builder.setBackgroundInsetTop(0)
builder.setBackgroundInsetStart(0)
builder.setBackgroundInsetEnd(0)
val dialog = builder.create()
dialog.show()
dialog.window?.let { window ->
    // 官方兼容方法：允许内容延伸到系统栏（状态栏、导航栏）区域
    WindowCompat.setDecorFitsSystemWindows(window, false)
    // 强制窗口尺寸占满整块屏幕
    val params = window.attributes
    params.width = WindowManager.LayoutParams.MATCH_PARENT
    params.height = WindowManager.LayoutParams.MATCH_PARENT
    window.attributes = params
    // MIUI系统特殊适配，关闭MIUI自带的对话框悬浮逻辑
    try {
        val setMiuiFloating = window.javaClass.getMethod("setIsMiuiFloating", Boolean::class.javaPrimitiveType)
        setMiuiFloating.invoke(window, false)
    } catch (e: Exception) {
        // 非MIUI设备直接跳过，不需要处理
    }
}

3. 布局根节点适配 #

给对话框对应的布局根节点加上以下两个属性，避免布局自身预留状态栏padding：

android:fitsSystemWindows="false"
android:clipToPadding="false"

完成以上配置后，即可在所有机型上实现对话框完全覆盖状态栏区域的效果。

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