多平台GitLab CI/CD构建咨询：Linux、macOS、Windows编译方案

完全可以用预先配置好依赖的macOS和Windows虚拟机来实现跨平台编译，GitLab CI支持针对不同操作系统的专属Runner，你只需要为这两个平台分别配置Runner，再扩展现有CI配置即可。

一、Windows平台实现步骤 #

1. 准备Windows虚拟机环境
   • 在Windows机器（或虚拟机）上安装好项目所需依赖：比如CMake、Visual Studio（或MSBuild）、对应版本的编译器等，先手动执行编译流程，确保能正常生成.dll共享库。
2. 注册Windows专属Runner
   • 进入GitLab项目的「Settings → CI/CD → Runners」，获取注册令牌和GitLab实例URL。
   • 在Windows机器上安装GitLab Runner，执行注册命令时选择shell executor（Windows上Docker镜像支持有限，直接用预配置的系统环境更可靠），并给Runner打上标签（比如windows、build），方便CI配置指定。
3. 添加Windows构建任务到CI配置
   在原有.gitlab-ci.yml中新增如下任务：

   build_windows:
     stage: build
     tags:
       - windows
       - build
     script:
       - mkdir build
       - cd build
       - cmake .. -G "Visual Studio 17 2022"  # 根据你安装的VS版本调整生成器
       - cmake --build . --config Release
     artifacts:
       paths:
         - build/Release/test.dll
   

二、macOS平台实现步骤 #

1. 准备macOS虚拟机环境
   • 在Mac机器（或支持macOS的虚拟机，如Parallels、VMware）上安装项目依赖：CMake、Xcode命令行工具、对应编译器等，手动验证编译流程能生成.dylib共享库。
2. 注册macOS专属Runner
   • 同样从GitLab项目的Runner设置中获取注册令牌和URL。
   • 在Mac机器上安装GitLab Runner，注册时选择shell executor，打上标签（比如macos、build）。
3. 添加macOS构建任务到CI配置
   新增如下任务：

   build_macos:
     stage: build
     tags:
       - macos
       - build
     script:
       - mkdir build
       - cd build
       - cmake ..
       - make
     artifacts:
       paths:
         - build/libtest.dylib
   

三、整合后的完整.gitlab-ci.yml #

将原有Linux任务与新增的Windows、macOS任务整合，最终配置如下：

stages:
- docker
- build

build_docker_image:
  stage: docker
  image: docker:20.10.16
  before_script:
    - docker login -u $REGISTRY_USER -p $REGISTRY_PASS
  script:
    - docker build -t "$REGISTRY_USER/my_dependencies:latest" .
    - docker push "$REGISTRY_USER/my_dependencies:latest"
  rules:
    - changes:
        - Dockerfile

build_linux:
  stage: build  
  image: "$REGISTRY_USER/my_dependencies:latest"
  script:
    - mkdir build
    - cd build
    - cmake ..
    - make 
  artifacts:
    paths:
      - build/libtest.so

build_windows:
  stage: build
  tags:
    - windows
    - build
  script:
    - mkdir build
    - cd build
    - cmake .. -G "Visual Studio 17 2022"
    - cmake --build . --config Release
  artifacts:
    paths:
      - build/Release/test.dll

build_macos:
  stage: build
  tags:
    - macos
    - build
  script:
    - mkdir build
    - cd build
    - cmake ..
    - make
  artifacts:
    paths:
      - build/libtest.dylib

关键注意事项 #

• Runner executor选择：macOS和Windows平台不推荐用Docker executor（Docker对这两个系统的基础镜像支持有限，尤其是macOS无法通过Docker直接使用原生系统镜像），shell executor直接调用预配置的系统环境是最稳定的方案。
• 依赖一致性：确保虚拟机中的依赖版本与Linux Docker镜像中的一致，避免因版本差异导致编译结果异常。
• 并行执行：三个平台的构建任务会在各自的Runner上并行运行，能有效提升流水线效率。

内容的提问来源于stack exchange，提问作者asdf