Qt for Linux/X11 - 从源代码构建

该页面描述了如何配置和从源代码构建 Qt for Linux/X11。请注意，通常通过 Qt 在线安装程序安装预构建的 Qt 库和工具会更容易。许多 Linux 发行版也通过其软件包管理器提供 Qt 软件包。但是，如果您想进一步自定义 Qt 或使用没有提供正确版本二进制 Qt 软件包的发行版，则应从源代码构建 Qt。

分发软件包打包者可以在打包建议中找到有关如何打包 Qt 的更多信息。

步骤 1：获取源代码

可以使用 Qt 在线安装程序安装 Qt 源代码。源代码包也可以通过 Git 获得，作为 Qt 账户（商业用户）中的存档和在 download.qt.io（开源用户）上。

如果您通过 Qt 在线安装程序安装源代码，它们将位于 Qt 安装目录中，例如 $HOME/Qt/6.7.2/Src。

如果下载了单个源代码存档，请将其提取到您选择的目录中

cd /tmp
tar xf ~/Downloads/qt-everywhere-src-6.7.2.tar.xz

步骤 2：安装构建需求

构建 Qt 需要包含工具、编译器和开发包的构建环境。

构建工具

工具	支持的版本
CMake	版本 3.16 及更高版本（用于 `-static` 构建，版本 3.21 及更高版本）。
Ninja	-
Python	版本 3

注意：如果可用的 ninja 可执行文件，configure 总是使用 Ninja 生成器和构建工具。Ninja 是跨平台的、功能丰富的、性能良好的，并在所有平台上推荐使用。其他生成器的使用可能可行，但未得到官方支持。

编译器和开发包

在 Qt 6.7 中支持以下编译器和配置

分发版	架构	编译器	说明
Red Hat 8.6	`x86_64`	GCC 10 (工具集)
Red Hat 8.8	`x86_64`	GCC 10 (工具集)
Red Hat 9.2	`x86_64`	GCC 11
openSUSE 15.5	`x86_64`	GCC 9
SUSE Linux Enterprise Server 15 SP5	`x86_64`	GCC 10
Ubuntu 22.04	`x86_64`	Canonical 提供的 GCC，GCC 11.x
在 ARM 上的 Debian 11.6	`arm64`	GCC 10	技术预览

其他编译器和配置可能可行，但未经过积极测试。

Qt 也依赖于各种库和开发包的可用性，通常这些库和包由各自的包管理器安装。有关详细信息，请参阅 Qt 对 X11 的要求。

步骤 3：构建 Qt 库和工具

要配置您的构建，请创建一个构建目录，并在该目录中运行 ./configure 脚本。

mkdir -p ~/dev/qt-build
cd ~/dev/qt-build
/tmp/qt-everywhere-src-6.7.2/configure

默认情况下，Qt 在 /usr/local/Qt-6.7.2 目录中配置为安装。可以使用 -prefix 选项进行更改。有关进一步的调整选项，请参阅配置选项列表。

configure 是否成功运行？如果是，请继续构建库和工具。

cmake --build . --parallel

构建后，您需要将库和工具安装到正确的地方（除非您启用了开发者构建）。

cmake --install .

请注意，这可能需要 root 权限。

步骤 4：使用 Qt

安装 Qt 后，您可以使用它开始构建应用程序。

如果您使用命令行工作，请考虑将 Qt 工具添加到您的默认 PATH。以下是如何执行此操作的说明

在 .profile 文件中（如果您的 shell 是 bash、ksh、zsh 或 sh），添加以下行

PATH=/usr/local/Qt-6.7.2/bin:$PATH
export PATH

在 .login 文件中（如果您的 shell 是 csh 或 tcsh），添加以下行

setenv PATH /usr/local/Qt-6.7.2/bin:$PATH

如果您计划在 IDE 中使用 Qt，您需要在那里明确注册 Qt 版本。对于 Qt Creator，请参阅 Qt Creator：添加 Qt 版本。