使用CMake/CPack分发带依赖的C++库的实现方案咨询

最优分发方案 #

最优方案是提供开箱即用的构建系统配置，避免用户手动处理头文件路径、依赖链接逻辑，具体实现要点如下：

• 基于CMake导出目标配置libA属性：给libA设置INTERFACE_LINK_LIBRARIES属性，值为libB和libC的CMake目标，用户只要链接libA的公开目标，CMake会自动追加libB、libC的链接逻辑，无需用户手动配置。
• 统一打包目录结构，仅对外暴露libA的公开头文件，示例结构如下：

  <安装根目录>
  ├── include/          # 仅存放libA的公开头文件，满足用户仅需引入libA头文件的需求
  ├── lib/
  │   ├── cmake/        # 存放CMake配置文件（libAConfig.cmake、版本校验文件、目标导出文件）
  │   ├── pkgconfig/    # 可选，存放pkg-config配置文件，适配非CMake用户
  │   ├── libA.a / libA.so / libA.lib  # libA二进制文件
  │   ├── libB.a / libB.so / libB.lib  # libB二进制文件
  │   └── libC.a / libC.so / libC.lib  # libC二进制文件
  └── bin/              # 可选，存放动态库对应的运行时文件
  

• 若libB、libC为私有依赖，直接随libA一同打包，不需要用户单独下载安装；若为公开第三方依赖，可在libA的CMake配置中添加find_package自动查找逻辑，找不到时给出明确安装提示。
• 按平台、架构、编译配置分开打包：Windows平台需要区分32/64位、Debug/Release版本、运行时版本（MT/MD等），Linux区分架构、glibc版本，避免用户混用二进制文件出现链接错误。
• 对非CMake用户，提供libA.pc pkg-config配置文件，在Libs字段完整填写所有依赖库的链接参数，用户通过pkg-config --libs libA即可一键获取全部链接选项。

CPack实现说明 #

完全可以使用CPack实现该需求，CPack是CMake官方配套的打包工具，天生适配CMake目标导出逻辑，操作步骤如下：

1. 完成项目CMake基础配置：
   • 用install(TARGETS libA libB libC EXPORT libATargets ...)指令指定头文件、二进制文件的安装路径
   • 用install(EXPORT libATargets FILE libATargets.cmake NAMESPACE libA:: DESTINATION lib/cmake/libA)导出目标配置
   • 用configure_package_config_file、write_basic_package_version_file生成libAConfig.cmake和版本校验文件，在配置文件中正确声明libA对libB、libC的依赖
2. 添加CPack配置到CMakeLists.txt末尾：

   set(CPACK_PACKAGE_NAME "libA")
   set(CPACK_PACKAGE_VERSION "1.0.0")
   set(CPACK_PACKAGE_DESCRIPTION "libA with dependencies libB and libC")
   # 按需指定打包格式，支持ZIP、TGZ、DEB、RPM、NSIS（Windows安装包）等
   set(CPACK_GENERATOR "ZIP;TGZ")
   include(CPack)
   

3. 编译项目后执行cpack命令，工具会自动把所有需要的头文件、二进制、构建配置文件打包为指定格式。用户拿到包后，只要在自己的CMakeLists.txt中添加find_package(libA REQUIRED)，然后链接libA::libA目标即可正常编译，完全不需要手动处理libB、libC的链接逻辑。

内容的提问来源于stack exchange，提问作者laks.it