Qt for X11 要求
平台插件依赖性
在 Linux 上使用xcbQPA(Qt 平台抽象)平台插件。它提供了 Qt GUI和 Qt Widgets所需的基本功能。其库依赖关系如下表所示。要从源代码构建 Qt,还需要为系统安装这些库的开发包。
库名 | 库 | 注释 | 配置选项 | 最小工作版本 |
---|---|---|---|---|
XRender | libXrender | X 渲染扩展;用于支持抗锯齿和阿尔法光标 | -xrender 或自动检测 | 0.9.0 |
xcb-render | libxcb-render | X 渲染扩展的 C 绑定 | 自动检测 | 1.11 |
xcb-render-util | libxcb-render-util | 用于渲染扩展的 XCB 工具库 | 自动检测 | 0.3.9 |
xcb-shape | libxcb-shape | 形状扩展的 X C 绑定 | 自动检测 | 1.11 |
xcb-randr | libxcb-randr | X 调整大小和旋转扩展的 C 绑定 | 自动检测 | 1.11 |
xcb-xfixes | libxcb-xfixes | 固定扩展的 X C 绑定 | 自动检测 | 1.11 |
xcb-xkb | libxcb-xkb | X C 键盘绑定扩展 | 自动检测 | 1.11 |
xcb-sync | libxcb-sync | 同步扩展的 X C 绑定 | 自动检测 | 1.11 |
xcb-shm | libxcb-shm | X 共享内存扩展的 C 语言绑定 | 自动检测 | 1.11 |
xcb-icccm | libxcb-icccm | X ICCCM 协议的 C 绑定 | 自动检测 | 0.3.9 |
xcb-keysyms | libxcb-keysyms | 用于 XCB 键码转换的实用程序库 | 自动检测 | 0.3.9 |
xcb-image | libxcb-image | 用于 XCB 的 XImage 和 XShmImage 实用程序库,用于QBackingStore 和光标支持。 | 自动检测 | 0.3.9 |
xcb-util | libxcb-util | 用于原子、辅助和事件的 XCB 工具库 | 自动检测 | 0.3.9 |
xcb-cursor0 | libxcb-cursor0 | XCB 用于游标的实用程序库 | 自动检测 | 0.1.1 |
xkbcommon | libxkbcommon | 键图处理 | -xkbcommon 或自动检测 | 0.5.0 |
xkbcommon-x11 | libxkbcommon-x11 | 键图处理 | 自动检测 | 0.5.0 |
字体配置 | libfontconfig | 字体定制和配置 | -fontconfig 或自动检测 | 2.6 |
自由字体 | libfreetype | 字体引擎 | 2.3.0 | |
Xext | libXext | X 扩展 | 6.4.3 | |
X11 | libX11 | X11 客户端库 | 6.2.1 | |
xcb | libxcb | X C 绑定库 | 1.11 | |
X11-xcb | libX11-xcb | Xlib/XCB 接口库 | 1.3.2 | |
SM | libSM | X 会话管理 | -sm 或自动检测 | 6.0.4 |
ICE | libICE | 客户端间交换 | -sm 或自动检测 | 6.3.5 |
glib | libglib-2.0 | 常见事件循环处理 | -glib 或自动检测 | 2.8.3 |
pthread | libpthread | 多线程 | 2.3.5 |
上述库的开发包包含从源代码构建 Qt 时使用的头文件。不同 Linux 发行版的软件包名称可能不同,有些发行版的软件包管理系统默认配置可能不包括所有软件包。
例如,你可以运行以下命令在基于 Debian 的 GNU/Linux 系统上安装推荐的软件包:
apt install \ libfontconfig1-dev \ libfreetype-dev \ libgtk-3-dev \ libx11-dev \ libx11-xcb-dev \ libxcb-cursor-dev \ libxcb-glx0-dev \ libxcb-icccm4-dev \ libxcb-image0-dev \ libxcb-keysyms1-dev \ libxcb-randr0-dev \ libxcb-render-util0-dev \ libxcb-shape0-dev \ libxcb-shm0-dev \ libxcb-sync-dev \ libxcb-util-dev \ libxcb-xfixes0-dev \ libxcb-xkb-dev \ libxcb1-dev \ libxext-dev \ libxfixes-dev \ libxi-dev \ libxkbcommon-dev \ libxkbcommon-x11-dev \ libxrender-dev
其中一些软件包依赖于此列表中的其他软件包,因此安装其中一个软件包可能会导致其他软件包自动安装。其他发行版可能会提供名称相似的系统软件包。
Qt 并没有为所有发行版维护一个全面的软件包列表。某些发行版,如 Red Hat™及其衍生版本,可能需要额外的软件源来安装某些软件包(如 RHEL 的 EPEL)。有关特定软件包的名称,请查阅发行版的文档。RHEL 用户可联系Red Hat 支持部门了解详细信息。
辅助功能依赖性
Qt 辅助功能实现使用辅助技术服务提供商接口(AT-SPI)。除 DBUS 外,还必须安装开发包libatspi2.0-dev
。
OpenGL 依赖项
配置尝试自动检测 OpenGL ES 2.0 或更高版本,或常规桌面 OpenGL。您可以使用-no-opengl
选项禁用 OpenGL 支持。
注意: Qt OpenGL 模块(包含以QGL 开头的类)已被弃用,取而代之的是 Qt GUI模块(包含以QOpenGL 开头的类)。
QDoc 依赖关系
QDoc使用 Clang 解析 C++ 代码。如果您希望手动构建 QDoc,请参阅为 QDoc 安装 Clang了解具体的构建要求。
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.