This page describes configuring and building Qt for Linux/X11 from sources. Note that it is typically easier to install the pre-built Qt libraries and tools via Qt 在线安装程序 . A lot of Linux distributions also provide Qt packages through their package manager. Build Qt from sources, however, if you want to customize Qt further or are using a distribution for which no binary Qt packages (in the right version) are available.
Distribution packagers can find further information on how to package Qt in the packaging recommendations .
Qt sources can be installed in Qt Online Installer. Source packages are also available through Git , as archives in the Qt 帐户 (commercial users), and on download.qt.io (open-source users).
If you install the sources through Qt Online Installer, they will be available in the Qt installation directory, for example
$HOME/Qt/6.7.2/Src
.
If you downloaded the single source archive, extract it to a directory of your choice:
cd /tmp tar xf ~/Downloads/qt-everywhere-src-6.7.2.tar.xz
Building Qt requires a build environment with tools, compilers, and development packages.
| 工具 | 支持版本 |
|---|---|
| CMake |
Version 3.16 and newer (3.21 and newer for
-static
builds).
|
| Ninja | - |
| Python | Version 3 |
注意：
configure always uses the
Ninja
generator and build tool if a
ninja
executable is available. Ninja is cross-platform, feature-rich, performant, and recommended on all platforms. The use of other generators might work but is not officially supported.
The following compilers and configurations are supported in Qt 6.7:
| 分发 | 体系结构 | 编译器 | 注意事项 |
|---|---|---|---|
| Red Hat 8.6 |
x86_64
|
GCC 10 (toolset) | |
| Red Hat 8.8 |
x86_64
|
GCC 10 (toolset) | |
| Red Hat 9.2 |
x86_64
|
GCC 11 | |
| openSUSE 15.5 |
x86_64
|
GCC 9 | |
| SUSE Linux Enterprise Server 15 SP5 |
x86_64
|
GCC 10 | |
| Ubuntu 22.04 |
x86_64
|
由 Canonical 提供的 GCC，GCC 11.x | |
| Debian 11.6 on ARM |
arm64
|
GCC 10 | 技术预览 |
Other compilers and configurations might work but are not actively tested.
Qt also relies on the availability of various libraries and development packages, which are typically installed by the package manager of the respective resolution. See Qt for X11 要求 for the details.
To configure your build, create a build directory and run the
./configure
script in this directory:
mkdir -p ~/dev/qt-build cd ~/dev/qt-build /tmp/qt-everywhere-src-6.7.2/configure
By default, Qt is configured for installation in the
/usr/local/Qt-6.7.2
directory. This can be changed by using the
-prefix
option. See the list of
configure options
to tweak further.
Did
configure
run successfully? Then proceed with building the libraries and tools:
cmake --build . --parallel
After building, you need to install the libraries and tools in the appropriate place (unless you enabled a developer build ):
cmake --install .
Note that this might require root access.
After Qt is installed, you can start building applications with it.
If you work from the command line, consider adding the Qt tools to your default
PATH
. This is done as follows:
在
.profile
(if your shell is bash, ksh, zsh or sh), add the following lines:
PATH=/usr/local/Qt-6.7.2/bin:$PATH export PATH
在
.login
(if your shell is csh or tcsh), add the following line:
setenv PATH /usr/local/Qt-6.7.2/bin:$PATH
If you plan to use Qt from an IDE, you need to register the Qt version explicitly there. For Qt Creator, see Qt Creator: Adding Qt Versions .
