简 述: 本文是 qt-everywhere-src-5.15.2.tar.xz 中的 README 的中文版本翻译(自译),其英文原文可见:HOW TO BUILD QT5。然后根据此中步骤,成功在 Mac Mojave 中成功编译和运行,其中具体的实战编译参考原文:在 Mac 编译成功运行 qt5.15 源码:debug 和 release 版本

[TOC]


本文初发于 “偕臧的小站” ifmet.cn,同步转载于此。


如何构建QT5

简介

系统要求

- Perl 5.8或更高版本
- Python 2.7或更高版本
- 支持C++11标准的C++编译器

 对于其他平台的具体要求。
 请参阅 "设置您的机器 "部分。
 http://wiki.qt.io/Get_The_Source

许可证:

Opensource users:

    <license>        = -opensource

Commercial users:

    <license>        = -commercial

Linux, Mac:

cd <path>/<source_package>
 ./configure -prefix $PWD/qtbase <license> -nomake tests
 make -j 4

Windows:

 打开一个命令提示符。
 确认路径中是否有以下工具。
 * 支持的编译器(Visual Studio 2012或更新版本。
    MinGW-builds gcc 4.9或更高版本)
 * Perl 5.12或更高版本[http://www.activestate.com/activeperl/]
 * Python 2.7或更高版本[http://www.activestate.com/activepython/]
 * Ruby 1.9.3或更高版本[http://rubyinstaller.org/]

 cd <path>\<source_package>
 configure -prefix %CD%\qtbase <license> -nomake tests
 nmake // jom // mingw32-make

 为了加速使用MSVC的qmake的引导,可能需要通过
 "-make-tool jom "在configure命令行。如果你不使用jom。
 在CL环境变量中添加"/MP "是个好主意。

更多细节请见下文。

Build!

使用典型的 “configure; make “构建过程。

一些相关的配置选项(参见configure -help)。

-release 编译并连接Qt,同时关闭调试功能。
-debug 编译并连接Qt,同时开启调试功能。
-nomake tests 禁用测试以加快编译速度。
-nomake examples 禁用例子以加快编译速度。
-confirm-license 自动确认LGPL 2.1授权。

例子为发布版构建。
(根据你的系统调整”-jN “参数)

./configure -prefix $PWD/qtbase
make -j4

开发者构建的例子。
(启用更多的自动测试,构建调试版的库,…)

./configure -developer-build
make -j4

请参阅`./configure -help’的输出,了解各种选项的文档。
配置。

上面的例子将构建任何已被启用的Qt5模块,并通过
构建系统中的默认值。

可以通过以下方式来构建选定的模块及其依赖关系。
`make module-‘。 例如,只建立qtdeclarative。
以及它所依赖的模块。

./configure -prefix $PWD/qtbase
make -j4 module-qtdeclarative

如果你只对Qt5的一个子集感兴趣,这可以节省很多时间。

提示

子模块仓库qtrepotools包含了一些有用的脚本,这些脚本用于
开发者和发布工程师。考虑添加qtrepotools/bin
到你的PATH环境变量来访问它们。

qtrepotools中的qt5_tool有一些更多的功能,可能会让你感兴趣。
试试`qt5_tool –help’。

从 git 构建 Qt5

参见http://wiki.qt.io/Building_Qt_5_from_Git 和 README.git
更多信息。
参见http://wiki.qt.io/Qt_5,了解参考平台。

文件资料

在配置和编译Qt后,可以通过运行下面的命令来构建文档。
“make docs”.

在建立了文档之后,你需要用以下方法安装它。
命令。

make install_docs

文档的安装路径设置为$QT_INSTALL_DOCS。
运行 “qmake -query “将列出QT_INSTALL_DOCS的值。

关于Qt 5的文档信息位于qtbase/doc/README
或在以下网页:http://wiki.qt.io/Qt5DocumentationProject

注:构建文档只在桌面平台上测试。