CMake:如何通过add_subdirectory构建兼容find_package()的独立导出项目
现有项目基础
- 核心对外交付库
MyLibrary已配置完善的导出逻辑,外部集成方可通过标准CMake方式调用:find_package(myLibrary) target_link_libraries(theirLibrary PUBLIC myNamespace::myLibrary) - 仓库内共托管3个独立的CMake项目,目录结构为:
MyRepository/ MyLibrary/ CMakeLists.txt include/ # 公共头文件目录 MyLibrary/ # 源码、私有头文件目录 MyDependentLibrary/ # 依赖MyLibrary的库项目 CMakeLists.txt ... MyExample/ # 依赖前两个库的可执行示例项目 CMakeLists.txt ... - 项目间依赖关系:
MyLibrary: 无内部依赖 MyDependentLibrary: 仅依赖MyLibrary MyExample: 依赖MyLibrary、MyDependentLibrary - 两个库项目均已配置安装导出、构建目录导出逻辑,完全兼容
find_package()查找逻辑,现有标准全量构建流程为:- 单独配置、构建
MyLibrary - 配置
MyDependentLibrary时手动指定MyLibrary_DIR路径,完成构建 - 配置
MyExample时手动指定MyLibrary_DIR、MyDependentLibrary_DIR路径,完成构建
- 单独配置、构建
- 该独立构建流程适配绝大多数交付场景:90%的情况下仅向客户交付单独编译好的
MyLibrary,无需附带另外两个项目。
遇到的开发诉求与问题
偶尔需要向客户交付全量3个项目的源码供参考,因此计划在仓库根目录新增顶层CMakeLists.txt,实现单入口一键构建全部项目,预期的顶层脚本内容大致为:
cmake_minimum_required(VERSION 3.10 FATAL_ERROR) project(MyCombinedProject VERSION 1.0.0 LANGUAGES CXX) add_subdirectory(MyLibrary) add_subdirectory(MyDependentLibrary) add_subdirectory(MyExample)
该方案运行时会出现配置报错:MyDependentLibrary因为找不到MyLibrary_DIR无法完成配置——这是因为聚合构建模式下MyLibrary尚未独立构建、未生成可被find_package()识别的导出配置文件。
本次调整的核心约束与目标:
- 修改各库的导出配置,让上述
add_subdirectory聚合的构建方式可以正常运行 - 调整过程完全不破坏原有独立构建、独立导出的兼容逻辑,保证单独交付
MyLibrary的场景不受任何影响 - 坚决不将
MyLibrary的核心构建逻辑迁移到顶层CMake脚本中
内容的提问来源于stack exchange,提问作者SCC
相关产品推荐
相关产品推荐

