Building QT

Since our entire build environment resides inside a Docker container, you don't need to install any packages on the host system. Everything is confined to the Docker image. Do however note that as of this writing, the multi-platform support is still in beta so, you need to enable this. Instructions for how to get started with multi-platform builds can be found here.

$ docker build \
    --build-arg GIT_HASH=$(git rev-parse --short HEAD) \
    -t qt-builder .

You should now be able to invoke a run executing the following command:

$ docker run --rm -t \
    -v ~/tmp/qt-src:/src:Z \
    -v ~/tmp/qt-build:/build:Z \
    qt-builder

This will launch build-qt5.sh and start the process of building QT for all Raspberry Pi boards. The resulting files will be placed in ~/tmp/qt-build/.

You can learn more about this process in our Compiling Qt with Docker multi-stage and multi-platform.

Build Arguments

You can append the following environment variables to configure the build process:

• CLEAN_BUILD: Set to 1 to ensure a clean build (not including the ccache cache).
• TARGET: Specify a particular target (such as pi3 or pi4) instead of all existing boards.

Debugging

You can enable QT debugging by using the following:

export QT_LOGGING_RULES=qt.qpa.*=true