darkmattercoder/qt-build

qt-build

镜像概述

这是一个基于Docker的近乎完整的Qt构建环境，采用多阶段构建分离构建过程与实际镜像，可通过单条命令快速构建qmake项目。镜像每周自动构建，确保基础镜像的更新及时同步到仓库。

核心功能

1. 支持多种Qt版本（如5.9、5.12、5.15等），提供稳定的构建环境。
2. 支持单命令构建qmake项目，输出文件直接保存在本地目录。
3. 提供交互式会话（bash）用于手动调整或调试构建过程。
4. 允许自定义构建参数（如Qt版本、核心数、下载分支等）。
5. 自动处理Qt构建配置，简化开发者环境搭建流程。

使用场景

1. 开发者快速搭建Qt开发环境，避免本地环境配置冲突。
2. CI/CD流程中集成Qt项目构建，确保构建环境一致性。
3. 测试不同Qt版本对项目的兼容性。

配置说明

快速使用

1. 拉取镜像：

   bash
   docker pull docker.xuanyuan.run/darkmattercoder/qt-build:latest
   

2. 构建qmake项目：

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

   构建结果将保存在项目目录下的build子目录中。

交互式会话

如需手动调整构建过程，可启动交互式bash：

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

自定义构建

若需构建特定Qt版本，可克隆源码并使用构建参数：

bash
git clone https://github.com/darkmattercoder/qt-build.git
cd qt-build
docker build --build-arg QT_VERSION_MAJOR=5 --build-arg QT_VERSION_MINOR=15 --build-arg QT_VERSION_PATCH=2 --build-arg CORE_COUNT=4 --target=qt -t qt-build:5.15.2

主要构建参数

• QT_VERSION_MAJOR：Qt主版本号（如5）。
• QT_VERSION_MINOR：Qt次版本号（如15）。
• QT_VERSION_PATCH：Qt补丁版本号（如2）。
• CORE_COUNT：并行构建核心数，根据机器配置调整。
• CI_BUILD：控制构建输出（1显示警告，2静默模式）。

可用标签

镜像提供多种Qt版本标签，如5.15.2、5.12、5.9等，详细列表可参考https://hub.docker.com/r/darkmattercoder/qt-build或https://github.com/darkmattercoder/qt-build。 ===END===