从 Git 仓库获取 Qt 源代码

简介

本节介绍如何通过 Git 版本控制系统获取 Qt 源代码。这对于已使用 Git 的软件开发流程以及测试不同的 Qt 版本非常有用。如果您计划为 Qt 做贡献，这也至关重要。

注意：Qt 源代码也可以使用 Qt 在线安装程序安装，从 Qt 账户（商业用户）或从 download.qt.io（开源用户）下载存档安装。

Qt 是在几个 Git 子模块中开发和维护的，这些子模块通过一个 qt5 超级模块连接在一起。从 Git 获取 Qt 源代码需要通过 Git 命令行工具克隆顶层 Git 仓库，并使用 Qt 的 configure 命令初始化子模块。

注意：Qt 5 和 Qt 6 使用相同的仓库，即使您使用 Qt 6，您也将针对 qt5 仓库工作。

首先，请查看构建 Qt 源代码和您平台的要求部分，以确保已安装所有先决条件。此外，您还需要 Git 的最新版本。

在计划克隆 Qt 源代码的位置时，请记住 Qt 支持从源代码外部构建，其中源代码位于与构建工件分开的目录中。这使 Git 克隆保持清洁，并能够从同一源树构建 Qt 的不同版本。在本概述中，包含 Qt 源代码的目录称为 qt-sources，而包含构建工具的目录称为 qt-build。

首先，创建 qt-sources 目录。在此目录中，使用 Git 默认克隆源代码。以下内容将使用 Git 命令行界面。请注意，末尾的点号（.）表示 Qt 将克隆到当前目录中。

git clone --branch v6.7.2 git://code.qt.io/qt/qt5.git .

您也可以使用 https 协议。

git clone --branch v6.7.2 https://code.qt.io/qt/qt5.git .

要测试最新开发版本，请省略 --branch 参数。

接下来，创建构建目录 qt-build。在此目录中，运行带有 -init-submodules 选项的 configure 命令。

qt-sources/configure -init-submodules

这将递归地初始化您的 qt-sources 目录中的所有 Qt 子模块，这可能需要一些时间。

请注意，-init-submodules 可以与其他 configure 参数一起使用。如果您知道您将与之工作的 Qt 子模块，请使用 -submodules 参数来减少配置时间。

qt-sources/configure -init-submodules -submodules qtdeclarative

这将初始化qtdeclarative和相关子模块。

设置好Qt源代码后，按照构建Qt源代码中概述的内容，为您的平台构建Qt。在初始Qt配置和切换分支后，才需要-init-repository参数。

对于计划为Qt做出贡献的人，需要在第一次配置Qt时指定-codereview-username。

qt-sources/configure -init-submodules --codereview-username <Gerrit username>

有关为Qt做出贡献和创建Gerrit用户名的更多信息，请参考Qt项目的主页。