Qt for Windows - 从源代码构建

此页面描述了配置和构建的过程，针对 Qt for Windows 。在构建之前，有一些要求更详细给出在 Qt for Windows - 要求文档。

可以下载 Qt 5 源代码，从下载页面。更多信息，拜访 Qt 快速入门页面。

步骤 1：安装许可文件 (仅商业许可的 Qt)

若在商业许可下使用 Qt，则 Qt 工具会查找本地许可文件。若正使用二进制安装程序或商用 Qt Creator，则会自动取出许可并存储在本地用户 Profile (配置文件) 中 ( %USERPROFILE%\AppData\Roaming\Qt\qtlicenses.ini file).

若不使用任何二进制安装程序或 Qt Creator，可以下载各自的许可文件从您的 Qt 帐户 Web 门户并将其保存到您的用户 Profile (配置文件) 作为 %USERPROFILE%\.qt-license 。若偏爱不同的位置或文件名，需要设置 QT_LICENSE_FILE 环境变量到各个文件路径。

步骤 2：解包存档

把文件解压到要安装 Qt 的目录；如 C:\Qt\%VERSION% .

注意： 安装路径不得包含任何空格或 Windows 特定文件系统字符。

步骤 3：设置环境变量

我们推荐创建桌面链接打开命令提示，采用的环境设置类似 命令提示 菜单条目提供通过 Visual Studio。这是通过创建应用程序链接完成，传递 .cmd 文件设置环境和命令行选项 /k (保持打开) 给 cmd.exe .

假定文件名为 qt5vars.cmd 和 Qt 文件夹名为 Qt-5 及位于 C:\Qt :

REM Set up Microsoft Visual Studio 2017, where <arch> is amd64, x86, etc.
CALL "C:\Program Files (x86)\Microsoft Visual Studio\2017\Professional\VC\Auxiliary\Build\vcvarsall.bat" <arch>
SET _ROOT=C:\Qt\Qt-5
SET PATH=%_ROOT%\qtbase\bin;%_ROOT%\gnuwin32\bin;%PATH%
REM Uncomment the below line when using a git checkout of the source repository
REM SET PATH=%_ROOT%\qtrepotools\bin;%PATH%
SET _ROOT=

然后，可以创建桌面链接通过指定命令 %SystemRoot%\system32\cmd.exe /E:ON /V:ON /k C:\Qt\qt5vars.cmd 作为应用程序和 C:\Qt\Qt-5 作为工作目录。

注意： 设置 MinGW 相似；唯一不同之处是 bin folder of the installation should be added to the path instead of calling the Visual Studio setup script. For MinGW ，请确保没有 sh.exe 可以在路径中被找到，因为它影响 mingw32-make .

其它库所需的设置 (见 Qt for Windows - 要求 ) 还应将此文件放置到 Windows SDK 设置脚本的调用下。

步骤 4：构建 Qt 库

configure 的默认行为是创建 Qt 5 的源代码内构建。若希望将 Qt 5 安装到单独位置，则需要指定命令行选项 -prefix <location> 。另外，命令行选项 -developer-build 创建供开发者使用的源代码内构建。

为您的机器的调试构建配置 Qt 库，在命令提示后键入以下命令：

configure -debug -nomake examples -nomake tests -skip qtwebengine -opensource

The 配置选项页面包含有关 configure 选项的更多信息。

要构建 Qt 使用 jom ，键入：

jom

若没有 jom 安装，键入：

nmake

For MinGW ，键入：

mingw32-make

若给定了安装前缀，键入 jom install , nmake install or mingw32-make install .

注意： 若以后需要在相同位置重新配置和重构 Qt，确保移除所有先前配置痕迹，通过进入构建目录并键入 nmake distclean 先于运行 configure 再次。

并行构建

jom 置换 nmake ，充分利用所有 CPU 核心，从而加速构建。

步骤 5：构建 Qt 文档编制

若想 Qt 参考文档编制可用于 Qt Assistant ，必须单独构建它：

nmake docs

这会在构建文件夹中构建文档编制。若您将 Qt 安装在单独位置，则还需要安装文档编制：

nmake install_docs