Qt::FramelessWindowHint在AppImage打包后失效如何解决

直接运行程序时调用的是系统原生Qt平台适配插件，窗口标识Qt::FramelessWindowHint可以正常传递给系统窗口管理器；打包为AppImage后，包内自带的裁剪版Qt平台插件、Wayland/X11协议适配逻辑差异，会导致构造函数中设置的窗口flag在原生窗口创建阶段被丢弃，窗口管理器收不到无边框请求，就会继续绘制默认窗口装饰。

• 调整窗口属性设置时机：不要在构造函数中设置无边框和透明属性，构造阶段窗口还未完成平台原生资源初始化，AppImage环境下该阶段设置的属性不会同步给窗口管理器。改为重写showEvent做单次设置，参考代码：

// 类头文件中添加私有成员标记
bool m_isFirstShow = true;

// 重写showEvent实现
void GWidget::showEvent(QShowEvent *e)
{
    if (m_isFirstShow) {
        Qt::WindowFlags wf = windowFlags();
        wf |= Qt::FramelessWindowHint;
        setWindowFlags(wf);
        setAttribute(Qt::WA_TranslucentBackground);
        m_isFirstShow = false;
    }
    QWidget::showEvent(e);
}

• 补全Wayland环境适配：当前多数Linux发行版默认使用Wayland显示协议，Qt 5.15以下版本对Wayland下的无边框窗口支持不完善，需要额外给底层原生窗口设置标识，在上述showEvent的flag设置逻辑中补充：

#if QT_VERSION >= QT_VERSION_CHECK(5,15,0)
    QWindow* nativeWin = windowHandle();
    if (nativeWin) {
        nativeWin->setFlag(Qt::FramelessWindowHint);
    }
#endif

• 修正AppImage打包配置：如果使用linuxdeployqt等工具打包，不要裁剪Qt平台适配插件，确保包内包含xcb、wayland相关的QPA插件库，不要添加-no-plugins这类跳过插件打包的参数；打包时不要使用过度精简的Qt base构建版本，避免丢失窗口协议交互相关逻辑。
• 添加启动兼容参数：可以在AppImage的入口启动脚本中提前声明环境变量QT_QPA_PLATFORM=xcb，强制程序走X11兼容模式启动，绕开Wayland下的协议兼容问题，不需要用户手动配置环境变量。

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