Qt 6.9.0下ExpandedClientAreaHint在Android端引发的界面异常及Android 15安全区域处理咨询

看起来你在Qt 6.9.0的Android QML应用里遇到了Qt.ExpandedClientAreaHint相关的界面适配问题，同时对Android 15的安全区域和边缘到边缘模式处理有疑问，我结合你的描述和代码来逐一分析：

一、ExpandedClientAreaHint引发的界面异常原因 #

Qt.ExpandedClientAreaHint的设计初衷是让应用窗口扩展到系统UI（状态栏、导航栏）下方，实现边缘到边缘显示，但在Android平台上，Qt对这个标志的适配逻辑在屏幕旋转、软键盘弹出这类系统UI状态变化时存在bug：

• 转屏或弹出键盘时，系统会重新计算窗口可用区域，Qt未能正确同步这个变化，导致原本被覆盖的系统UI区域的边距被错误添加到窗口中，出现额外空白边距。
• 状态栏图标透明的问题，是因为窗口扩展到状态栏下方后，Qt没有正确设置状态栏图标的颜色适配（深色/浅色模式），导致图标和你的蓝色窗口背景对比度不足，视觉上呈现透明效果。

二、Android 15下安全区域与边缘到边缘模式的正确处理 #

针对Android 15（API 35）的边缘到边缘模式和安全区域，不能单纯依赖Qt.ExpandedClientAreaHint，需要结合Qt API和Android原生配置协同处理：

1. 先配置AndroidManifest.xml #

在AndroidManifest中添加边缘到边缘的支持配置，让系统识别应用的适配模式：

<!-- 若使用Qt自动生成的Manifest，可在Qt Creator项目配置中修改或手动编辑生成后的文件 -->
<style name="AppTheme" parent="android:Theme.Material.Light.NoActionBar">
    <item name="android:windowLayoutInDisplayCutoutMode">shortEdges</item>
    <item name="android:windowTranslucentStatus">true</item>
    <item name="android:windowTranslucentNavigation">true</item>
    <item name="android:statusBarColor">@android:color/transparent</item>
    <item name="android:navigationBarColor">@android:color/transparent</item>
</style>

2. QML端安全区域的正确用法 #

你代码里的SafeArea使用方式有误，正确做法是把需要避开系统UI的内容直接放在SafeArea内部，而非手动设置margin。同时搭配合适的窗口flags，解决图标透明问题：

ApplicationWindow {
    id: window
    visible: true
    // 搭配FramelessWindowHint增强边缘到边缘效果，减少系统UI干扰
    flags: Qt.Window | Qt.FramelessWindowHint | Qt.ExpandedClientAreaHint

    Component.onCompleted: {
        // 根据窗口背景色设置状态栏图标颜色，解决透明问题
        if (window.color === "blue") {
            Qt.android.setStatusBarIconColor(Qt.lightGray)
        }
    }

    // SafeArea自动处理安全边距，无需手动设置margin
    SafeArea {
        anchors.fill: parent
        Rectangle {
            id: childItem
            color: "red"
            anchors.fill: parent
        }
    }
}

3. 处理屏幕旋转与软键盘适配 #

为避免转屏或键盘弹出时的边距异常，可监听相关状态变化，强制刷新窗口布局：

ApplicationWindow {
    // ... 其他代码 ...

    Connections {
        target: Screen
        function onOrientationChanged() {
            window.update()
        }
    }

    Connections {
        target: Qt.inputMethod
        function onVisibleChanged() {
            window.update()
        }
    }
}

三、测试环境相关补充 #

你使用的Ubuntu 22.04 + Qt 6.9.0 + Android SDK 35的配置是合理的，Gradle版本差异不会影响该适配问题，核心还是Qt对Android边缘到边缘模式的处理bug。目前在Android 13/14/15上表现一致，说明这是Qt跨版本的适配问题，暂时可以用上面的方案作为临时解决办法，后续可关注Qt官方的版本修复。

内容来源于stack exchange