Android 15下Jetpack Compose Dialog Window Insets适配问题求助

问题核心原因 #

1. 你手动设置了contentWindowInsets = WindowInsets(0,0,0,0)，直接禁用了Scaffold默认的系统安全区域Insets传递，导致.safeContentPadding()无法获取有效参数
2. Android 15的Pixel设备对Compose Dialog的Insets处理逻辑与三星设备存在差异，默认情况下Dialog未正确触发系统Insets请求

解决方案 #

方案1：修正Scaffold基础配置（优先尝试）

移除全0的contentWindowInsets设置，同时删除Modifier上多余的.safeContentPadding()——Scaffold的contentPadding会自动处理安全区域：

fun MyDialog() {
    Scaffold(
        modifier = Modifier.fillMaxSize(),
        // 使用默认安全区域Insets，或指定需要的Insets类型（如WindowInsets.safeDrawing）
        contentWindowInsets = WindowInsets.safeDrawing
    ) { contentPadding ->
        Box(
            modifier = Modifier
                .padding(contentPadding)
                .fillMaxSize()
        ) {
            // 你的Dialog内容示例
            Button(
                modifier = Modifier.align(Alignment.BottomCenter),
                onClick = {}
            ) {
                Text("确认")
            }
        }
    }
}

方案2：手动强制Dialog适配Insets

如果方案1无效，可通过LocalView获取Dialog的Window，关闭系统自动适配逻辑后手动处理Insets：

fun MyDialog() {
    val view = LocalView.current
    // 强制Dialog的Window不自动适配系统Insets，改为手动处理
    DisposableEffect(Unit) {
        val window = view.context.findWindow()
        window?.setDecorFitsSystemWindows(false)
        onDispose {
            window?.setDecorFitsSystemWindows(true)
        }
    }

    val safeInsets = LocalWindowInsets.current.safeDrawing.asPaddingValues()

    Scaffold(
        modifier = Modifier.fillMaxSize()
    ) {
        Box(
            modifier = Modifier
                .padding(safeInsets)
                .fillMaxSize()
        ) {
            // 你的Dialog内容
        }
    }
}

// 扩展函数：从Context获取Window实例
fun Context.findWindow(): Window? {
    return when (this) {
        is Activity -> window
        is ContextWrapper -> baseContext.findWindow()
        else -> null
    }
}

方案3：强制触发Insets刷新

针对Android 15 Pixel设备的特殊逻辑，在Dialog初始化时强制请求系统Insets刷新：

fun MyDialog() {
    val coroutineScope = rememberCoroutineScope()
    val view = LocalView.current

    LaunchedEffect(Unit) {
        coroutineScope.launch {
            // 强制View请求系统Insets更新
            view.requestApplyInsets()
        }
    }

    val safeInsets = LocalWindowInsets.current.safeDrawing.asPaddingValues()

    Scaffold(
        modifier = Modifier.fillMaxSize()
    ) {
        Box(modifier = Modifier.padding(safeInsets)) {
            // 你的Dialog内容
        }
    }
}

关键注意事项 #

• 不要同时使用Scaffold的contentWindowInsets和Modifier的.safeContentPadding()，两者会产生逻辑冲突
• Pixel设备在Android 15上对Dialog的Insets校验更严格，需确保Dialog的Window正确发起Insets请求
• 三星设备因系统定制逻辑，自动处理了Dialog的Insets适配，因此未出现问题

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