Android API<30下Jetpack Compose系统导航内边距为0的问题

原因分析 #

在API < 30的设备上，Compose默认无法自动从父View层级接收WindowInsets，核心原因有两点：

• API 30之前的View系统Insets传递机制没有统一的转发逻辑，ComposeView作为View与Compose的桥梁，默认不会主动将View侧的Insets传递给Compose内容。
• 在onCreateView的setContent块中直接获取WindowInsets.navigationBars时，Compose布局尚未完成，Insets数据还未被正确初始化或传递到Compose层级。

解决方案 #

方案1：让ComposeView转发View侧Insets到Compose #

初始化ComposeView时添加Insets转发逻辑，确保View侧的Insets能传递到Compose：

override fun onCreateView(
    inflater: LayoutInflater,
    container: ViewGroup?,
    savedInstanceState: Bundle?,
): View {
    return ComposeView(requireContext()).apply {
        // 让ComposeView转发WindowInsets到Compose内容
        ViewCompat.setOnApplyWindowInsetsListener(this) { v, insets ->
            val consumed = ViewCompat.onApplyWindowInsets(v, insets)
            // 将Insets传递给Compose
            (v as ComposeView).setWindowInsets(insets)
            consumed
        }

        setContent {
            val composeSystemInsets = WindowInsets.navigationBars
            val density = LocalDensity.current
            
            // 用LaunchedEffect等待布局完成后再获取Insets
            LaunchedEffect(Unit) {
                println("---> Compose: ${composeSystemInsets.getBottom(density)}")
            }

            // 通过navigationBarsPadding()确保Insets被Compose正确识别
            Box(Modifier.navigationBarsPadding()) {
                // 你的Compose内容
            }
        }
    }
}

方案2：通过Compose布局回调获取就绪的Insets #

在Compose中使用布局回调等待布局完成后获取Insets，同时确保ComposeView已接收View侧Insets：

setContent {
    val density = LocalDensity.current

    // 用全局布局回调获取Insets
    Box(
        Modifier.onGloballyPositioned { coordinates ->
            val insets = coordinates.windowInsets.navigationBars
            println("---> Compose: ${insets.getBottom(density)}")
        }
    ) {
        // 你的Compose内容
    }
}

关键注意事项 #

• 不要在setContent初始化阶段直接获取Insets，此时Compose布局未完成，数据可能未就绪。
• 检查父View是否消费了Insets（比如设置了fitsSystemWindows=true但未转发），若父View消费了Insets，Compose侧将无法获取正确值。

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