c++如何使用GitHub Actions进行CI/CD_c++自动化构建、测试与部署

使用GitHub Actions可实现C++项目CI/CD自动化,推送代码后自动构建、测试、生成覆盖率报告并部署发布。配置.github/workflows下的YAML文件定义流程,支持多编译器(GCC/Clang)与多平台矩阵构建,通过ctest运行单元测试,结合lcov生成覆盖报告,利用codecov上传结果;CI通过后可打包产物,打tag时自动创建GitHub Release,实现从提交到发布的全流程自动化,提升开发效率与代码质量。

在C++项目中使用GitHub Actions实现CI/CD,可以自动化完成代码构建、单元测试和部署流程,提升开发效率与代码质量。整个过程无需本地反复操作,只要推送代码,就能自动验证是否通过编译和测试。

配置GitHub Actions工作流

GitHub Actions通过.github/workflows目录下的YAML文件定义自动化流程。新建一个YAML文件(如ci-cd.yml),即可定义C++项目的CI/CD步骤。

基础结构如下:

name: C++ CI
on: [push, pull_request]
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
  - name: Install dependencies
    run: |
      sudo apt-get update
      sudo apt-get install g++ cmake make

  - name: Configure with CMake
    run: cmake -B build

  - name: Build project
    run: cmake --build build

  - name: Run tests
    run: |
      cd build
      ctest --output-on-failure

支持多平台与多编译器

C++项目常需在不同编译器(如GCC、Clang)或操作系统(Linux、Windows、macOS)下验证兼容性。GitHub Actions支持矩阵构建(matrix strategy),可一次性测试多种环境。

示例:使用GCC和Clang在Ubuntu上构建

jobs:
  build:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        compiler: [gcc, clang]
    env:
      CC: ${{ matrix.compiler == 'gcc' && 'gcc' || 'clang' }}
      CXX: ${{ matrix.compiler == 'gcc' && 'g++' || 'clang++' }}
    steps:
      - uses: actions/checkout@v4
  - name: Install ${{ matrix.compiler }}
    run: |
      sudo apt-get update
      sudo apt-get install ${{ matrix.compiler }} ${{ matrix.compiler }}++

  - name: Configure and Build
    run: |
      cmake -B build
      cmake --build build

  - name: Run Tests
    run: cd build && ctest

集成单元测试与覆盖率报告

若项目使用Google Test等测试框架,可在构建后运行测试并生成覆盖率报告。结合工具如gcovlcov,可分析代码覆盖情况。

添加测试依赖与覆盖率收集:

- name: Install GTest
  run: |
    sudo apt-get install libgtest-dev
    cd /usr/src/gtest
    sudo cmake CMakeLists.txt
    sudo make
    sudo cp *.a /usr/lib
  • name: Build with coverage run: | cmake -B build -DCMAKE_BUILD_TYPE=Debug -DCOVERAGE=ON cmake --build build

  • name: Generate coverage report run: | cd build lcov --capture --directory . --output-file coverage.info python3 -m http.server 8000 & echo "Coverage report available at https://www./link/fcbb3a1c04ec11f1506563c26ca63774"

也可使用codecov上传报告到在线服务:

- name: Upload to Codecov
uses: codecov/codecov-action@v3
with:
  file: ./build/coverage.info

自动化部署二进制文件或发布版本

当CI通过后,可自动打包构建产物并发布为GitHub Release,适用于发布命令行工具或库。

在工作流末尾添加部署步骤:

- name: Archive build artifacts
  if: success()
  uses: actions/upload-artifact@v3
  with:
    name: binaries
    path: build/
  • name: Create GitHub Release if: startsWith(github.ref, 'refs/tags/') uses: softprops/action-gh-release@v1 with: tag_name: ${{ github.ref_name }} files: build/*

这样,当你打一个Git tag(如v1.0.0),就会自动创建Release并附上构建好的可执行文件。

基本上就这些。通过合理配置GitHub Actions,C++项目也能拥有高效可靠的自动化流程,从提交代码到部署发布一气呵成,不复杂但容易忽略细节。