搭建基于vcpkg和cmake的跨平台构建流水线的核心在于利用vcpkg管理依赖，cmake组织构建流程，从而实现代码在不同操作系统和编译器上的自动化编译和测试。1. 安装配置vcpkg：克隆仓库并运行引导脚本，设置vcpkg_root环境变量，可选地将vcpkg加入path；2. 创建cmakelists.txt：指定最低版本、项目名称、引入vcpkg工具链、查找并链接所需库；3. 使用vcpkg安装依赖：根据平台架构执行如vcpkg install boost:x64-windows或x64-linux等命令；4. 配置构建流水线：通过ci/cd工具安装vcpkg与cmake，使用cmake生成构建系统并进行编译；5. 解决跨平台依赖问题：通过vcpkg的triplet机制选择对应平台依赖；6. 优化构建速度：使用缓存、ninja构建系统、并行编译及增量编译；7. 处理私有仓库：设置vcpkg_overlay_ports指向自定义port目录以优先加载内部库。
搭建基于vcpkg和CMake的跨平台构建流水线，核心在于利用vcpkg管理依赖，CMake组织构建流程，从而实现代码在不同操作系统和编译器上的自动化编译和测试。
首先，我们需要一个可靠的依赖管理方案和一套标准化的构建流程。vcpkg解决了依赖管理的问题，CMake则提供了跨平台的构建能力。将两者结合，能显著简化跨平台构建的复杂性。
为什么选择vcpkg和CMake？
vcpkg简化了第三方库的获取和管理。它能够自动下载、构建和安装依赖项，并能轻松管理不同版本的库。CMake则是一个强大的构建系统生成器，它可以生成各种构建系统（如Makefile、Ninja、Visual Studio项目等）的配置文件，使得项目可以在不同的平台上使用相同的构建流程。
搭建步骤
-
安装和配置vcpkg:
- 从GitHub克隆vcpkg仓库：
git clone https://github.com/microsoft/vcpkg - 运行vcpkg的引导脚本：
.\vcpkg\bootstrap-vcpkg.bat(Windows) 或./vcpkg/bootstrap-vcpkg.sh(Linux/macOS) - 设置环境变量
VCPKG_ROOT指向vcpkg的安装目录。 - (可选) 将vcpkg添加到PATH环境变量，方便直接使用
vcpkg命令。
- 从GitHub克隆vcpkg仓库：
-
创建CMakeLists.txt:
- 在项目根目录下创建
CMakeLists.txt文件。 - 设置CMake最低版本要求：
cmake_minimum_required(VERSION 3.15) - 项目名称：
project(MyProject) - 引入vcpkg工具链文件：
set(CMAKE_TOOLCHAIN_FILE ${VCPKG_ROOT}/scripts/buildsystems/vcpkg.cmake) - 查找需要的库：
find_package(Boost REQUIRED)(例如，查找Boost库) - 添加可执行文件或库：
add_executable(MyProject main.cpp) - 链接需要的库：
target_link_libraries(MyProject Boost::boost)
- 在项目根目录下创建
-
使用vcpkg安装依赖:
- 使用
vcpkg install安装需要的依赖。例如，vcpkg install boost:x64-windows(Windows 64位) 或vcpkg install boost:x64-linux(Linux 64位)。 - 指定平台和架构非常重要，确保安装的库与目标平台兼容。
- 使用
-
配置构建流水线:
客客出品专业威客系统KPPW下载客客出品专业威客系统KPPW（简称KPPW）是武汉客客团队自主研发的开源系统项目，主要应用于威客模式的在线服务交易平台搭建。KPPW客客出品的专业威客系统，是keke produced professional witkey的缩写。产品业务核心功能是基于任务悬赏交易和用户服务商品交易为主构建一个C2C的电子商务交易平台，其主要交易对象是以用户为主的技能、经验、时间和智慧型商品。经过多年发展,KPP
- 可以使用各种CI/CD工具（如GitHub Actions、GitLab CI、Azure DevOps等）配置构建流水线。
- 在流水线中，首先安装vcpkg和CMake。
- 然后，使用CMake生成构建系统：
cmake -B build -S . - 最后，使用生成的构建系统进行编译：
cmake --build build
如何解决跨平台依赖问题？
不同平台可能需要不同版本的依赖库，或者依赖库的名称有所差异。vcpkg通过triplet的概念来解决这个问题。Triplet定义了目标平台、架构和编译器。例如，x64-windows, x64-linux, x64-osx都是不同的triplet。
在构建流水线中，可以根据不同的平台选择不同的triplet进行安装。例如，在GitHub Actions中，可以使用if语句来判断当前运行的平台，然后选择合适的triplet：
steps:
- name: Install dependencies (Windows)
if: runner.os == 'Windows'
run: vcpkg install boost:x64-windows
- name: Install dependencies (Linux)
if: runner.os == 'Linux'
run: vcpkg install boost:x64-linux如何优化构建速度？
构建速度是影响开发效率的关键因素。以下是一些优化构建速度的技巧：
- 使用缓存: CI/CD工具通常提供缓存机制，可以将vcpkg安装的依赖缓存起来，避免每次构建都重新下载和编译。
-
使用Ninja构建系统: Ninja是一个小而快的构建系统，通常比Makefile构建速度更快。可以在CMake中指定使用Ninja：
cmake -B build -S . -GNinja -
并行编译: 使用多线程进行并行编译可以显著提高构建速度。可以在CMake构建命令中指定线程数：
cmake --build build -j - 增量编译: CMake支持增量编译，只编译修改过的文件。确保CMake配置正确，以便充分利用增量编译的优势。
如何处理vcpkg的私有仓库？
有时候，我们需要使用私有的vcpkg仓库，例如包含公司内部的库。这可以通过配置VCPKG_OVERLAY_PORTS环境变量来实现。
VCPKG_OVERLAY_PORTS指向包含自定义port文件的目录。vcpkg会优先搜索这些目录，然后再搜索官方的vcpkg仓库。
例如，假设我们有一个私有仓库位于/path/to/my-vcpkg-ports，可以在构建流水线中设置环境变量：
env: VCPKG_OVERLAY_PORTS: /path/to/my-vcpkg-ports
然后在私有仓库中创建相应的port文件，例如ports/mylib/portfile.cmake。
