Qt for Windows - Building from Source

本页描述了配置和构建 Qt for Windows 的过程. 在构建之前, Qt for Windows - Requirements 文档中更详细地给出了一些要求.

你可以从 Downloads 页面下载 Qt 5 源代码. 详见 Getting Started with Qt.

Step 1: Install the License File (Commercially Licensed Qt Only)

如果你有商业 Qt 许可证, 请从你的 Qt Account Web 门户下载许可证文件, 并将其作为 .qt-license 保存到你的主目录中.

Step 2: Unpack the Archive

将文件解压到你想要安装 Qt 的目录中; 如. C:\Qt\%VERSION%.

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

Step 3: Set the Environment Variables

我们建议创建一个桌面链接, 用于打开命令提示符, 其环境设置类似于 Windows SDK 提供的 Command Prompt 菜单条目. 你可以创建一个应用程序链接, 将设置环境的 .cmd 文件和命令行选项 /k (保持打开状态) 传递给 cmd.exe.

假设该文件名为 qt5vars.cmd, 并且 Qt 文件夹名为 qt-5, 位于 C:\qt:

  REM Set up \Microsoft Visual Studio 2013, where <arch> is \c amd64, \c x86, etc.
  CALL "C:\Program Files (x86)\Microsoft Visual Studio 12.0\VC\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 文件夹添加到路径中，而不是调用 Visual Studio 安装脚本. 对于 MinGW, 请确保路径中找不到 sh.exe, 因为它会影响 mingw32-make.

附加库所需的设置 (参见 Qt for Windows Requirements) 也应位于对 Windows SDK 设置脚本的调用下方的此文件中.

Step 4: Build the Qt Library

configure 的默认行为是创建 Qt 5 的源内构建. 如果要将 Qt 5 安装到单独的位置, 则需要指定命令行选项 -prefix <location>. 或者, 命令行选项 -developer-build 创建一个源内构建供开发人员使用.

要为你的计算机配置 Qt 库以调试构建, 请在命令提示符中键入以下命令:

  configure -debug -nomake examples -opensource

有关 configure 选项的更多信息, 参见 Configure Options.

使用 jom 构建 Qt, 输入:

  jom

如果你没有安装 jom, 输入:

  nmake

对于 MinGW, 输入:

  mingw32-make

如果设置 prefix, 输入 jom install, nmake install or mingw32-make install.

注意: 如果稍后需要从同一位置重新配置和重建 Qt, 确保进入构建目录并在再次运行 configure 之前, 输入 nmake distclean 删除先前配置的所有痕迹.

Parallel Builds

jom 是 nmake 的替代品, 它利用所有 CPU 核心, 从而加快构建速度.

Step 5: Build the Qt Documentation

要在 Qt Assistant 中使用 Qt 参考文档, 你必须单独构建它:

 nmake docs

这将在构建文件夹中构建文档. 如果你已将 Qt 安装在单独的位置, 则还需要安装文档:

 nmake install_docs