Android 13+中BottomSheetDialogFragment无法设置正常背景遮罩度求助

问题现象 #

在Android 13（API 33+）环境中，BottomSheetDialogFragment仅能设置1.0f的dimAmount（对应纯黑背景），设置0.99f及以下时背景会完全透明。无论是在Styles.xml配置属性，还是在代码中直接设置，均无法生效。

用户尝试过的无效操作：

1. 样式文件配置：

<item name="android:backgroundDimEnabled">true</item>
<item name="android:backgroundDimAmount">0.3</item>

2. 代码中设置：

requireDialog().window?.apply {
    addFlags(FLAG_DIM_BEHIND)

    val lp = attributes
    lp?.dimAmount = 0.32f
    attributes = lp

    setDimAmount(0.99f)
}

仅当设置setDimAmount(1.0f)时，背景才会变为纯黑色，其他值都会导致背景完全透明。

解决办法 #

Android 13及以上版本中，BottomSheetDialog的背景遮罩逻辑被内部逻辑覆盖，导致常规dim设置失效，可通过以下两种方式解决：

方法一：自定义BottomSheetDialog样式，禁用默认背景处理 #

1. 在styles.xml中添加自定义样式：

<style name="CustomBottomSheetDialogStyle" parent="@style/Theme.Design.Light.BottomSheetDialog">
    <item name="bottomSheetStyle">@style/CustomBottomSheetStyle</item>
</style>

<style name="CustomBottomSheetStyle" parent="@style/Widget.Design.BottomSheet.Modal">
    <item name="android:background">@android:color/transparent</item>
    <item name="backgroundTint">@android:color/transparent</item>
    <item name="android:backgroundDimEnabled">true</item>
    <item name="android:backgroundDimAmount">0.32</item>
</style>

2. 在你的BottomSheetDialogFragment中指定该样式：

override fun getTheme(): Int {
    return R.style.CustomBottomSheetDialogStyle
}

方法二：手动添加遮罩视图，绕过默认逻辑 #

在onViewCreated中获取BottomSheet根布局，手动添加遮罩并关联BottomSheet状态：

override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
    super.onViewCreated(view, savedInstanceState)
    
    val bottomSheetDialog = dialog as BottomSheetDialog
    val bottomSheet = bottomSheetDialog.findViewById<View>(com.google.android.material.R.id.design_bottom_sheet)
    
    // 创建遮罩View，设置0.32f的透明度
    val dimView = View(requireContext()).apply {
        setBackgroundColor(Color.argb((0.32f * 255).toInt(), 0, 0, 0))
        alpha = 0f
        visibility = View.VISIBLE
    }
    
    // 将遮罩添加到Dialog窗口根布局
    dialog?.window?.decorView?.let { decorView ->
        val rootView = decorView.findViewById<ViewGroup>(android.R.id.content)
        rootView.addView(dimView, ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.MATCH_PARENT)
        
        // 监听BottomSheet状态，同步遮罩显示/隐藏
        bottomSheetDialog.behavior.addBottomSheetCallback(object : BottomSheetBehavior.BottomSheetCallback() {
            override fun onStateChanged(bottomSheet: View, newState: Int) {
                dimView.alpha = if (newState == BottomSheetBehavior.STATE_HIDDEN) 0f else 1f
            }
            
            override fun onSlide(bottomSheet: View, slideOffset: Float) {
                dimView.alpha = slideOffset
            }
        })
    }
}

内容的提问来源于stack exchange，提问作者Артём Тарасов