rabits/qt

Qt工具链镜像

本镜像包含多个版本的Qt工具链，支持桌面和安卓平台，旨在帮助开发者自动化开源Qt应用的CI（持续集成）流程。目前提供以下版本：

• qt:5.4-desktop、qt:5.4-android
• qt:5.7-desktop、qt:5.7-android
• qt:5.9-desktop、qt:5.9-android
• qt:5.10-desktop、qt:5.10-android
• qt:5.11-desktop、qt:5.11-android
• qt:5.12-desktop、qt:5.12-android
• qt:5.13-desktop、qt:5.13-android-armv7、qt:5.13-android-arm64
• qt:5.14-desktop、qt:5.14-android
• qt:5.15-desktop、qt:5.15-android

核心功能

• 提供预配置的Qt构建环境，支持桌面（Desktop）和安卓（Android）平台
• 简化开源Qt项目的CI流程，减少环境配置时间
• 包含不同Qt版本，满足项目对特定版本的依赖需求

使用场景

• 开源Qt应用的自动化构建与测试
• 跨平台（桌面、安卓）Qt应用的编译打包
• 持续集成（CI/CD）流水线中的构建环节

配置说明

使用镜像步骤

1. 克隆项目仓库：

   bash
   host$ git clone https://github.com/ACCOUNT/PROJECT.git
   

2. 运行Docker容器：
   • 桌面版本：

     bash
     host$ docker run -it --rm --volume="${PWD}/PROJECT:/home/user/project:ro" rabits/qt:5.14-desktop
     

   • 安卓版本：

     bash
     host$ docker run -it --rm --volume="${PWD}/PROJECT:/home/user/project:ro" rabits/qt:5.14-android
     

3. 安装额外构建依赖（示例）：

   bash
   docker$ sudo apt update; sudo DEBIAN_FRONTEND=noninteractive apt install -y gnupg2
   docker$ curl https://apt.llvm.org/llvm-snapshot.gpg.key | sudo apt-key add -
   docker$ echo 'deb http://apt.llvm.org/bionic/ llvm-toolchain-bionic-10 main' | sudo tee /etc/apt/sources.list.d/llvm-10.list
   docker$ sudo apt update ; sudo apt install -y clang-format-10
   

4. 创建构建目录：

   bash
   docker$ mkdir -p build && cd build
   

5. 生成构建脚本：
   • 桌面版本：

     bash
     docker$ cmake ../project -G Ninja "-DCMAKE_PREFIX_PATH:PATH=${QT_DESKTOP}"
     

   • 安卓版本（多ABI）：

     bash
     docker$ cmake ../project -G Ninja -DCMAKE_BUILD_TYPE:STRING=Release -DANDROID_ABI:STRING=armeabi-v7a -DANDROID_BUILD_ABI_arm64-v8a:BOOL=ON -DANDROID_BUILD_ABI_x86:BOOL=ON -DANDROID_BUILD_ABI_x86_64:BOOL=ON "-DANDROID_NATIVE_API_LEVEL:STRING=${ANDROID_NATIVE_API_LEVEL}" "-DANDROID_SDK:PATH=${ANDROID_SDK_ROOT}" "-DANDROID_NDK:PATH=${ANDROID_NDK_ROOT}" "-DCMAKE_PREFIX_PATH:PATH=${QT_ANDROID}" "-DCMAKE_FIND_ROOT_PATH:STRING=${QT_ANDROID}" "-DCMAKE_TOOLCHAIN_FILE:PATH=${ANDROID_NDK_ROOT}/build/cmake/android.toolchain.cmake"
     

6. 构建二进制文件：

   bash
   docker$ cmake --build .
   

构建5.14及后续版本的容器镜像

Qt调整了安装政策，需要登录账号才能安装。可通过以下方式安全传递凭据：

1. 创建secrets.env文件（需拥有Qt账号）：

   bash
   export QT_CI_LOGIN='你的邮箱'
   export QT_CI_PASSWORD='你的密码'
   

2. 启动简单HTTP服务器以提供secrets.env文件（示例用Python）：

   bash
   $ python3 -m http.server 8765
   

3. 验证文件可访问：

   bash
   $ curl http://0.0.0.0:8765/secrets.env
   

4. 保持HTTP服务器运行，执行Docker构建命令（需获取主机IP）：

   bash
   $ cd 5.14-android
   $ docker build --pull --rm=true --build-arg 'QT_CI_ENV_URL=http://172.17.0.1:8765/secrets.env' -t YOUR_LOGIN/qt:$(basename "${PWD}") .
   

5. 完成后，你的Qt镜像即构建成功。

参考链接

使用的extract-qt脚本来自：https://github.com/benlau/qtci/blob/master/bin/extract-qt-installer