abeimler/simple-cppbuilder

Simple C++ Docker构建镜像

该镜像基于archlinux:base-devel，集成了C++开发所需的编译器、构建工具和依赖管理器，帮助开发者快速搭建标准化构建环境，支持多种编译场景与跨平台需求。

核心功能

• 编译器：gcc、clang及多种交叉编译器（如mingw-w64、emscripten、树莓派交叉工具链）
• 构建工具：cmake、make、ninja、Taskfile脚本
• 依赖管理：conan、vcpkg
• 辅助工具：ccache、cppcheck、doxygen、python等

使用场景

1. C++项目的本地快速编译与测试
2. CI/CD流水线中的自动化构建任务
3. 跨平台项目（Windows、Android、WebAssembly、树莓派）的交叉编译
4. 依赖复杂的C++项目开发与调试

配置说明

镜像变体

• :base：基础版（gcc+conan+基础构建工具）
• :latest/:<version>：默认版（base基础上添加vcpkg）
• :clang：clang编译器版本
• :x64-mingw-w64：Windows x64交叉编译版本
• :emscripten：WebAssembly编译版本
• :rpi4/:rpi3：树莓派交叉编译版本
• :ci：CI/CD专用Ubuntu基础版本

环境变量

• CC：C编译器（默认gcc）
• CXX：C++编译器（默认g++）
• CMAKE_GENERATOR：CMake生成器（默认Ninja）
• BUILD_TYPE：构建类型（默认Release）
• TARGET：CMake目标（默认all）

部署示例

Dockerfile示例

Dockerfile
# 构建阶段
FROM docker.xuanyuan.run/abeimler/simple-cppbuilder as build
COPY . .
CMD ["task", "-t", "/home/taskfiles/Taskfile.yml", "build"]

# 测试阶段
FROM docker.xuanyuan.run/build as test
CMD ["task", "-t", "/home/taskfiles/Taskfile.yml", "test"]

构建并运行

bash
docker build -t my-cpp-project .
docker run -it --rm --name my-app docker.xuanyuan.run/my-cpp-project

单文件编译

bash
docker run -it --rm -v "$PWD":/home/project -w /home/project docker.xuanyuan.run/abeimler/simple-cppbuilder ./docker-build.sh

Docker Compose构建示例

yaml
version: '3.4'
services:
  gcc-release-build:
    build:
      context: .
      dockerfile: Dockerfile
      target: build
    environment:
      CC: gcc
      CXX: g++
      BUILD_TYPE: Release
      CMAKE_GENERATOR: Ninja

运行命令：docker-compose up --build

许可证

查看镜像https://github.com/abeimler/simple-cppbuilder/blob/main/LICENSE。镜像包含的基础系统及依赖软件可能遵循其他许可证，用户需确保使用符合相关许可要求。

相关链接

• https://hub.docker.com/r/abeimler/simple-cppbuilder
• https://github.com/abeimler/simple-cppbuilder