targetSdk=30下BottomSheetDialog设置半透明导航栏失效如何解决？

问题根因 #

1. 主题中开启的enableEdgeToEdge是Material Components提供的自动沉浸式适配开关，开启后会强制将导航栏、状态栏覆盖为全透明，你在XML中配置的半透明android:navigationBarColor会被直接覆盖，这是半透明效果不生效的核心原因。
2. 你在WindowInsets处理逻辑中为sheetView设置了bottomMargin = -insets.bottom，相当于将BottomSheet内容区域强制延伸到导航栏下方，就算导航栏配置了半透明颜色，也会被BottomSheet的内容遮挡，无法显示效果。
3. android:windowTranslucentNavigation是Android 4.4阶段的旧API，在targetSdk>=30的沉浸式适配模式下优先级低于android:navigationBarColor，同时和enableEdgeToEdge存在冲突，不建议混用。
4. 系统默认开启android:enforceNavigationBarContrast属性，会自动给导航栏添加对比度遮罩，也会导致自定义半透明颜色不符合预期。

修复步骤 #

1. 调整主题配置 #

关闭自动沉浸式开关，手动控制导航栏样式：

<style name="BottomSheetDialogTheme" parent="Theme.MaterialComponents.Light.BottomSheetDialog">
    <!-- 关闭自动沉浸式适配，避免覆盖自定义导航栏颜色 -->
    <item name="enableEdgeToEdge">false</item>
    <item name="android:statusBarColor">@android:color/transparent</item>
    <!-- 直接配置你需要的半透明导航栏颜色 -->
    <item name="android:navigationBarColor">#40FFFFFF</item>
    <!-- 关闭系统自动添加的导航栏对比度遮罩 -->
    <item name="android:enforceNavigationBarContrast">false</item>
</style>

2. 调整WindowInsets处理逻辑 #

删除负边距设置，避免内容遮挡导航栏：

override fun onAttachedToWindow() {
    super.onAttachedToWindow()

    val window = window
        ?: error("window not attached?!")
    val sheetView = findViewById<View>(com.google.android.material.R.id.design_bottom_sheet)
        ?: error("bottom sheet design not found")

    WindowInsetsControllerCompat(window, sheetView).apply {
        isAppearanceLightNavigationBars = true
    }

    ViewCompat.setOnApplyWindowInsetsListener(sheetView) { _, windowInsets ->
        val insets = windowInsets.getInsets(WindowInsetsCompat.Type.systemBars())
        // 仅给内容添加底部padding，避免内容被导航栏遮挡
        sheetView.updatePadding(
            bottom = insets.bottom
        )
        // 无需消费Insets，也不要设置负bottomMargin
        windowInsets
    }
}

可选：保留enableEdgeToEdge的适配方案 #

如果你需要保留enableEdgeToEdge配置，只需在onAttachedToWindow中新增一行代码动态覆盖导航栏颜色即可：

window.navigationBarColor = Color.parseColor("#40FFFFFF")

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