Android AlertDialog各版本屏幕变暗效果不一致问题求助

问题原因 #

Android 14（API 34）对AlertDialog的窗口默认行为做了调整：默认不再启用全局屏幕变暗，仅保留对话框周围的阴影效果，而API 29及以下版本默认会触发全局变暗。之前调用setDimAmount()无效的核心原因是API34+默认未开启FLAG_DIM_BEHIND窗口标记，导致变暗配置不生效。

解决方案 #

通过显式配置AlertDialog的窗口属性，强制开启全局变暗逻辑，覆盖所有Android版本：

修改后的Kotlin代码 #

import android.os.Build
import android.view.WindowManager
import androidx.appcompat.app.AlertDialog

private fun showPopup(){
    val dialogBuilder = AlertDialog.Builder(this)
    val dialog = dialogBuilder.create()
    val dialogView = layoutInflater.inflate(R.layout.popup_sharing_number, null)
    dialog.setView(dialogView)
    
    // 核心配置：强制开启全局变暗
    dialog.window?.apply {
        // 添加背后变暗标记，确保全版本生效
        addFlags(WindowManager.LayoutParams.FLAG_DIM_BEHIND)
        // 设置变暗程度（0.0=完全不暗，1.0=全黑，推荐0.7）
        setDimAmount(0.7f)
        
        // API34+额外处理：关闭系统默认阴影，避免与变暗效果冲突
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.UPSIDE_DOWN_CAKE) {
            attributes.windowAnimations = android.R.style.Animation_Dialog
            attributes.clearFlags(WindowManager.LayoutParams.FLAG_SHOW_WALLPAPER)
        }
    }
    
    dialog.show()
}

额外主题检查（若仍无效） #

如果上述代码仍不生效，检查应用主题是否禁用了背景变暗：
在res/values/styles.xml的App主题中添加以下配置：

<style name="AppTheme" parent="Theme.Material3.Light.NoActionBar">
    <!-- 确保对话框背景变暗功能启用 -->
    <item name="android:backgroundDimEnabled">true</item>
    <!-- 全局默认变暗程度（可选，可被代码中的setDimAmount覆盖） -->
    <item name="android:backgroundDimAmount">0.7</item>
</style>

关键说明 #

• FLAG_DIM_BEHIND：必须开启此标记，否则setDimAmount()不会生效，这是API34+版本的核心修复点
• dimAmount：可根据需求调整数值，0.7是兼顾可读性和遮罩效果的常用值
• API34+的额外处理：关闭系统默认的对话框阴影，避免出现阴影与变暗叠加的违和感

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