Building Qt 6 from Git

From Qt Wiki
Jump to navigation Jump to search

En Ar Bg De El Es Fa Fi Fr Hi Hu It Ja Kn Ko Ms Nl Pl Pt Ru Sq Th Tr Uk Zh

This article provides hints for checking out and building the Qt 6 repositories. This is primarily for developers who want to contribute to the Qt library itself, or who want to try the latest unreleased code.

If you simply want to build a specific release of Qt from source to use the libraries in your own project, you can download the source code from the Official Releases page or the Archive. Alternatively, commercial customers can download the Source Packages via the Qt Account portal.

To compile Qt Creator, see Building Qt Creator from Git.

To compile Qt 5, see Building Qt 5 from Git

System Requirements

All desktop platforms

  • Git (>= 1.6.x)
  • CMake (>= 3.18.4)
  • Ninja
  • Perl (>=5.14)
  • Python (>=2.6.x)
  • A working C++ compiler, supporting at least C++ 17

Getting the source code

First clone the top-level Qt git repository:

$ git clone git://code.qt.io/qt/qt5.git

or (if you're behind a firewall and want to use the https protocol):

$ git clone https://code.qt.io/qt/qt5.git

Do not worry about the name mentioning qt5.git. This is also used for Qt 6.

Then check out the target branch (see Branch Guidelines). Currently, the only branch that exists for Qt 6 is dev, but in the future this will change, allowing to e.g. check out sources from 6.1

$ cd qt5
$ git checkout 6.1

Getting the submodule source code

As described in the README.git, initialize the repository using the init-repository script, which clones the various sub-modules of Qt 6.

$ cd qt5
$ perl init-repository

In order to build a specific release of Qt, you can checkout the desired tag:

$ cd qt5
$ git checkout v6.0.0-beta2
$ perl init-repository

Configuring and Building

Qt 6 is built with CMake, and can be configured also by just running cmake with appropriate otpions. We provide some convenience scripts though that makes configuring Qt, and individual Qt modules easier.

A build script called configure (or configure.bat for Windows) will be in the directory that you git cloned the source code into (~/qt5 if you followed the directions above). You will want to call that script from a different, parallel-level directory, because you do not want to build Qt in the directory that holds the source code. Instead, you should use a "shadow build", meaning you should not build into the source directory.

$ mkdir qt6-build
$ cd qt6-build
$ ../qt5/configure -D CMAKE_INSTALL_PREFIX=/path/to/install
$ cmake --build .
$ cmake --install .

On Windows:

> mkdir qt6-build
> cd qt6-build
> ..\qt5\configure.bat -D CMAKE_INSTALL_PREFIX=C:\path\to\install
> cmake --build .
> cmake --install .

Run configure -help to get an overview of available options. The most popular ones are

  • -developer-build : Sets the install prefix to the build directory, so that no install step is necessary. It also changes defaults so that all tests (including tests using private API that is otherwise not exported) can run.

The configure script maps the options given to CMake options. You can directly pass CMake options after a --, for instance to enforce Ninja as build tool:

 > ../qt5/configure -- -G Ninja


See cmake/README.md in the sources for details on how to configure and build Qt 6 with CMake.