darkmattercoder/qt-build repository overview

⁠qt-build

A (nearly) full qt build environment using docker. Using multi-stage build to decouple build from actual image. Can build a qmake project with one single command.

Find the images on Dockerhub⁠. Find the sources on Github⁠

Automated builds will run weekly, thus changes in the underlying base images will reach the registry within that time.

⁠What about Qt 6?

When I started this project in 2018, I had no Idea, that it would be useful for so many of you. The Qt company released Qt 6.0.0 on December 08, 2020. A lot of changes have been introduced in the code base and mainly Qt decided to finally get rid of qmake as build system. Since this is a siginificant change, I do not plan to provide build images for Qt 6 in this very repository. Instead, I am currently working to provide those images via a separate repository, which I do not want to include more clutter than necessary. Qt 6 is the perfect starting point for this. However, since the user base for the images I provide through this very repository has grown in size, I will for sure not abandon this repository and keep maintaining it at least as long as Qt 5 is officially supported. Most probably even longer. Right now, my focus however is to provide good and well usable docker images for Qt 6, which is what currently requires a bit more attention than this Qt 5 based repo. Once I feel ready, I will put a corresponding link here to make readers aware of it.

⁠What is missing

Due to a build time limitation of 3 hours with travis ci, I unfortunately am not able to provide qtwebengine with my builds. Once I either get help with transferring the build pipeline to another platform, where the time limitation is not that strict, or once travis give their VMs more cores for build jobs so that the build fits in 3 hours, I can include qtwebengine in my builds. Until then, you have to build the image locally with the provided script (description below) and adjust the build config if you absolutely need it.

⁠Usage (short)

Download qt-build from dockerhub:

docker pull darkmattercoder/qt-build:latest

Provide your qmake project that you want to build in a separate directory and build it with qt-build:

docker run --rm -u $UID -v /path/to/your/project/directory:/var/build darkmattercoder/qt-build:latest build

You will find your built project in a new sub directory named build in your project directory. You can safely omit the -u $UID part in most environments, where your user has the standard UID=1000.

⁠Usage (detailed)

The latest-tag will give you the latest released qt version for your build environment. For different versions available, refer to the available tags⁠-section.

Generally you will find full version tags like 5.11.3 as well as minor version tags that refer to the last patch release for the given minor release like 5.11 or 5.12. There will be some tags listed that are named like builder-x.y.z, where x,y,z represent qt version numbers. Those images are used for ci builds of the images and contain the whole qt source overhead. They are used as caches in the ci environment. You normally do not want to use them for any production stuff, because they are fairly large.

The build command for docker run will build any qmake project that is mounted to /var/build. However, you can get an interactive session as well for manual adjustments or examinations:

docker run --rm -it -u $UID -v /path/to/your/project/directory:/var/build darkmattercoder/qt-build:latest bash

If you pass additional arguments to build they will be taken into account as arguments to qmake which allows you to modify your build if needed.

⁠Building it yourself

git clone https://github.com/darkmattercoder/qt-build.git
cd qt-build
docker build --build-arg QT_VERSION_MAJOR=X --build-arg QT_VERSION_MINOR=Y --build-arg QT_VERSION_PATCH=Z --build-arg CORE_COUNT=N --target=qt -t qt-build:X.Y.Z

Replace X,Y,Z according to your desired qt version. You have to provide a build configuration as a very simple configure-script in the buildconfig directory to make the build succeed. The script has to be named after your desired QT version, e.g. configure-5.11.3.sh. Example content:

#!/bin/sh
../configure -prefix $QT_PREFIX -opensource -confirm-license -nomake examples -nomake tests

⁠Build arguments

The build arguments can entirely be omitted, resulting in a build with some default values from the Dockerfile. However, I do not promise that those default values for the Qt-Version that are hardcoded in the Dockerfile will get updated on a regular basis, because I inject the desired versions all in my ci build matrix. Available build arguments are:

• QT_VERSION_MAJOR
• QT_VERSION_MINOR
• QT_VERSION_PATCH
• QT_DOWNLOAD_BRANCH -- gives you the possibility to address different versions for download. Should e.g. read official_releases or archive.
• QT_TARBALL_NAMING_SCHEME -- gives you the possibility to alter the naming scheme. Qt changed that between 5.9and 5.10 ftom qt-everywhere-opensource-src to qt-everywhere-src. The qt- and -src parts are hardcoded, QT_TARBALL_NAMING_SCHEME is inserted between
• CI_BUILD -- will suppress regular make output. If set to 2 it will stay silent, if set to 1 (or anything else) only warnings will show up. When the compiling fails, make is run again regularly to give you the whole output, skipping everything that has been built before, to give you the possibility to see the actual behaviour. When left undefined, all output is visible and the second run of make is not performed
• CORE_COUNT -- determines the number of parallel make jobs. Adjust it to fit your machine

⁠Convenience local build script

In case you want to do a quick, customised build like I do it in the automated build process. Have a look at the self-explanatory script build-dockerfile-local.sh.

⁠Available and maintained tags

All currently supported versions of Qt should be available as tags. I added also versions that have been supported at the time adding them first, but are now archived. I'd like to add other archived versions, too, but I did not yet put any effort into thet. This is no hard work though, so might be a nice

Some images have been built and are available in the dockerhub registry, but due to missing sources on the qt download servers, they cannot be built automatically anymore and thus, its base layer image is not updated anymore. You should consider that when you want to use them. Find them in the second table below.

Tags	Size	Layers
[![imgVerInfo][ver_img_5.12.3]][lnk_5.12.3]	[![imgSizeInfo][size_img_5.12.3]][lnk_5.12.3]	[![imgLayerInfo][layers_img_5.12.3]][lnk_5.12.3]
[![imgVerInfo][ver_img_5.12.2]][lnk_5.12.2]	[![imgSizeInfo][size_img_5.12.2]][lnk_5.12.2]	[![imgLayerInfo][layers_img_5.12.2]][lnk_5.12.2]
[![imgVerInfo][ver_img_5.12.1]][lnk_5.12.1]	[![imgSizeInfo][size_img_5.12.1]][lnk_5.12.1]	[![imgLayerInfo][layers_img_5.12.1]][lnk_5.12.1]
[![imgVerInfo][ver_img_5.12.0]][lnk_5.12.0]	[![imgSizeInfo][size_img_5.12.0]][lnk_5.12.0]	[![imgLayerInfo][layers_img_5.12.0]][lnk_5.12.0]
[![imgVerInfo][ver_img_5.9]][lnk_5.9] [![imgVerInfo][ver_img_5.9.9]][lnk_5.9.9]	[![imgSizeInfo][size_img_5.9.9]][lnk_5.9.9]	[![imgLayerInfo][layers_img_5.9.9]][lnk_5.9.9]
[![imgVerInfo][ver_img_5.9.8]][lnk_5.9.8]	[![imgSizeInfo][size_img_5.9.8]][lnk_5.9.8]	[![imgLayerInfo][layers_img_5.9.8]][lnk_5.9.8]
[![imgVerInfo][ver_img_5.9.7]][lnk_5.9.7]	[![imgSizeInfo][size_img_5.9.7]][lnk_5.9.7]	[![imgLayerInfo][layers_img_5.9.7]][lnk_5.9.7]
[![imgVerInfo][ver_img_5.9.6]][lnk_5.9.6]	[![imgSizeInfo][size_img_5.9.6]][lnk_5.9.6]	[![imgLayerInfo][layers_img_5.9.6]][lnk_5.9.6]
[![imgVerInfo][ver_img_5.9.5]][lnk_5.9.5]	[![imgSizeInfo][size_img_5.9.5]][lnk_5.9.5]	[![imgLayerInfo][layers_img_5.9.5]][lnk_5.9.5]
[![imgVerInfo][ver_img_5.9.4]][lnk_5.9.4]	[![imgSizeInfo][size_img_5.9.4]][lnk_5.9.4]	[![imgLayerInfo][layers_img_5.9.4]][lnk_5.9.4]
[![imgVerInfo][ver_img_5.9.3]][lnk_5.9.3]	[![imgSizeInfo][size_img_5.9.3]][lnk_5.9.3]	[![imgLayerInfo][layers_img_5.9.3]][lnk_5.9.3]
[![imgVerInfo][ver_img_5.9.2]][lnk_5.9.2]	[![imgSizeInfo][size_img_5.9.2]][lnk_5.9.2]	[![imgLayerInfo][layers_img_5.9.2]][lnk_5.9.2]
[![imgVerInfo][ver_img_5.9.1]][lnk_5.9.1]	[![imgSizeInfo][size_img_5.9.1]][lnk_5.9.1]	[![imgLayerInfo][layers_img_5.9.1]][lnk_5.9.1]
[![imgVerInfo][ver_img_5.9.0]][lnk_5.9.0]	[![imgSizeInfo][size_img_5.9.0]][lnk_5.9.0]	[![imgLayerInfo][layers_img_5.9.0]][lnk_5.9.0]

⁠Available but unmaintained tags