avolphen/amd64-gnu-cpp repository overview

⁠C++ Qt amd64/x86_64 Build Image

⁠Primary Goal

Create a comprehensive Docker-based C++ build environment that supports:

1. Multi-platform C++ compilation

   • Native Linux (x86_64 and aarch64)
   • Windows cross-compilation (x86_64) using the Linux MinGW cross-compiler
   • Windows compilation (using MinGW and MSVC via Wine)

2. Qt framework support

   • Building Qt from source for multiple platforms
   • Packaging and hosting Qt libraries (versions like 6.8.1, 6.9.1, 6.10.1) for different architectures
   • Cross-platform Qt development (Linux → Windows)

3. Developer tooling

   • JetBrains CLion integration for containerized development
   • Support for debugging and running GUI applications via X11
   • The Python tool is available in native Linux and also in Wine to support cross-platform build-scripts.

⁠Key Technical Features

• Base image: Ubuntu 24.04 LTS with comprehensive C++ toolchain
• Cross-compilation: aarch64 and Windows (x86_64) support from x86_64 hosts
• Wine integration: For Windows tooling, MSVC and MinGW compilation on Linux
• Library management: Automated packaging/uploading of Qt libraries to Nexus
• Entrypoint: Sophisticated user/permission handling to match host UID/GID
• FUSE mounting: Zip-mounted libraries and toolchains for space efficiency

.

The system enables consistent, reproducible C++ builds across platforms while maintaining developer workflow flexibility.

⁠Python Build Script

The bin/build.py script from the CMake Library⁠ is responsible for automating the build process of C++ projects using CMake.
The script provides a bootstrap option for creating a new C++ boilerplate project. It provides a convenient interface for developers to execute build commands.
The same script can be used for both Linux and Windows, including CI/CD-pipelines.
See the Python script in action see the YouTube⁠ channel.

⁠Running Standalone without the Project

When running a container using this image you need to start it using these options to enable fuse-zip mounts used for the 3 different architectures of Qt frameworks.
Running as root --user 0:0 is needed to change the from user user the uid and gid.

--user 0:0
--net host
--cap-add SYS_ADMIN
--device /dev/fuse
--security-opt apparmor:unconfined

Adding option --volume ${PWD}:/mnt/project makes the container run with the uid and gid of the project directory owner.
Adding option --env LOCAL_USER=<uid>:<gid> makes the container run with the given uid and gid.
Add options --env DISPLAY --volume ${HOME}/.Xauthority:/home/user/.Xauthority:ro to allow hosts X-server access for X11 GUI apps.

⁠Versions of Tools

List of versions in the image.

⁠Tag: 24.04-6.10.1

⁠Tag: 24.04-6.9.1

⁠Tag: 24.04-6.8.1