HOW TO BUILD QT5（5.15）

心已赠人 2022-11-04 01:00 119阅读 0赞

### 文章目录 ###

*  HOW TO BUILD QT5
 *  Synopsis
 *   *  System requirements
     *  Licensing:
     *  Linux, Mac:
     *  Windows:
 *  Build!
 *  Hints
 *  Building Qt5 from git
 *  Documentation

**简 述：**　本文是 [qt-everywhere-src-5.15.2.tar.xz][] 解压后的英文原文的 `README` 译文，其中文译文可见：[如何构建 QT5（5.15）][QT5_5.15]。然后根据此中步骤，成功在 `Mac Mojave` 中成功编译和运行，其中具体的实战编译参考原文：[在 Mac 编译成功运行 qt5.15 源码：debug 和 release 版本][Mac _ qt5.15 _debug _ release]

> 本文初发于 **“偕臧的小站”** [ifmet.cn][]，同步转载于此。

# HOW TO BUILD QT5 #

# Synopsis #

## System requirements ##

- Perl 5.8 or later
    - Python 2.7 or later
    - C++ compiler supporting the C++11 standard
    
     For other platform specific requirements,
     please see section "Setting up your machine" on:
     http://wiki.qt.io/Get_The_Source

## Licensing: ##

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: ##

Open a command prompt.
     Ensure that the following tools can be found in the path:
     * Supported compiler (Visual Studio 2012 or later,
        MinGW-builds gcc 4.9 or later)
     * Perl version 5.12 or later   [http://www.activestate.com/activeperl/]
     * Python version 2.7 or later  [http://www.activestate.com/activepython/]
     * Ruby version 1.9.3 or later  [http://rubyinstaller.org/]
    
     cd <path>\<source_package>
     configure -prefix %CD%\qtbase <license> -nomake tests
     nmake // jom // mingw32-make
    
     To accelerate the bootstrap of qmake with MSVC, it may be useful to pass
     "-make-tool jom" on the configure command line. If you do not use jom,
     adding "/MP" to the CL environment variable is a good idea.

More details follow.

# Build! #

A typical \`configure; make’ build process is used.

Some relevant configure options (see configure -help):

\-release Compile and link Qt with debugging turned off.  
\-debug Compile and link Qt with debugging turned on.  
\-nomake tests Disable building of tests to speed up compilation  
\-nomake examples Disable building of examples to speed up compilation  
\-confirm-license Automatically acknowledge the LGPL 2.1 license.

Example for a release build:  
(adjust the \`-jN’ parameter as appropriate for your system)

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

Example for a developer build:  
(enables more autotests, builds debug version of libraries, …)

./configure -developer-build  
make -j4

See output of \`./configure -help’ for documentation on various options to  
configure.

The above examples will build whatever Qt5 modules have been enabled by  
default in the build system.

It is possible to build selected modules with their dependencies by doing  
a \`make module-’. For example, to build only qtdeclarative,  
and the modules it depends on:

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

This can save a lot of time if you are only interested in a subset of Qt5.

# Hints #

The submodule repository qtrepotools contains useful scripts for  
developers and release engineers. Consider adding qtrepotools/bin  
to your PATH environment variable to access them.

The qt5\_tool in qtrepotools has some more features which may be of interest.  
Try \`qt5\_tool --help’.

# Building Qt5 from git #

See http://wiki.qt.io/Building\_Qt\_5\_from\_Git and README.git  
for more information.  
See http://wiki.qt.io/Qt\_5 for the reference platforms.

# Documentation #

After configuring and compiling Qt, building the documentation is possible by running  
“make docs”.

After having built the documentation, you need to install it with the following  
command:

make install_docs

The documentation is installed in the path set to $QT\_INSTALL\_DOCS.  
Running “qmake -query” will list the value of QT\_INSTALL\_DOCS.

Information about Qt 5’s documentation is located in qtbase/doc/README  
or in the following page: http://wiki.qt.io/Qt5DocumentationProject

Note: Building the documentation is only tested on desktop platforms.

[qt-everywhere-src-5.15.2.tar.xz]: https://download.qt.io/official_releases/qt/5.15/5.15.2/single/qt-everywhere-src-5.15.2.tar.xz
[QT5_5.15]: https://ifmet.cn/posts/df7f9a4d/
[Mac _ qt5.15 _debug _ release]: https://ifmet.cn/posts/8b05b275/
[ifmet.cn]: https://ifmet.cn