CMake项目依赖内部第三方库时安装导出报错的解决咨询

报错原因 #

这个错误的核心是导出主库目标myLib_myLib时，它依赖的myDependency目标未被纳入CMake的导出集合。

CMake的install(EXPORT)机制有严格要求：所有被导出目标直接或间接依赖的非系统目标，必须要么被同样导出，要么属于已存在的导出集。你的项目中，myDependency作为内部第三方库仅完成了编译配置，但未设置对应的install和EXPORT规则，导致CMake处理主库导出时，无法找到myDependency的导出元数据，因此抛出错误。

修复方案 #

需要分两步配置，先完善myDependency的导出规则，再调整主项目的关联配置。

1. 给myDependency添加导出规则 #

修改thirdparty/myDependency/CMakeLists.txt，在目标定义后补充install和导出相关配置，将myDependency纳入导出集合：

# 原有目标定义（示例）
add_library(myDependency
  myDependency.cxx
)
target_include_directories(myDependency
  PUBLIC
    $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}>
    $<INSTALL_INTERFACE:include/myDependency>
)

# -------------------新增导出规则-------------------
# 安装目标文件
install(TARGETS myDependency
  EXPORT myDependencyTargets
  LIBRARY DESTINATION lib
  ARCHIVE DESTINATION lib
  RUNTIME DESTINATION bin
  INCLUDES DESTINATION include/myDependency
)

# 安装公共头文件（根据实际头文件路径调整）
install(FILES myDependency.h
  DESTINATION include/myDependency
)

# 导出目标到cmake配置文件
install(EXPORT myDependencyTargets
  FILE myDependencyTargets.cmake
  NAMESPACE myDependency::
  DESTINATION lib/cmake/myDependency
)

# 生成版本与配置文件（可选但推荐）
include(CMakePackageConfigHelpers)
write_basic_package_version_file(
  "${CMAKE_CURRENT_BINARY_DIR}/myDependencyConfigVersion.cmake"
  VERSION 1.0.0
  COMPATIBILITY SameMajorVersion
)

# 创建myDependencyConfig.cmake.in文件，内容仅需一行：include("${CMAKE_CURRENT_LIST_DIR}/myDependencyTargets.cmake")
configure_package_config_file(
  "${CMAKE_CURRENT_SOURCE_DIR}/myDependencyConfig.cmake.in"
  "${CMAKE_CURRENT_BINARY_DIR}/myDependencyConfig.cmake"
  INSTALL_DESTINATION lib/cmake/myDependency
)

install(FILES
  "${CMAKE_CURRENT_BINARY_DIR}/myDependencyConfig.cmake"
  "${CMAKE_CURRENT_BINARY_DIR}/myDependencyConfigVersion.cmake"
  DESTINATION lib/cmake/myDependency
)

2. 调整主项目CMake配置，关联myDependency导出集 #

修改主项目根目录的CMakeLists.txt，确保主库依赖的myDependency使用命名空间目标，并在主库的导出配置中关联依赖：

# 导入myDependency子项目
add_subdirectory(thirdparty/myDependency)

# 原有主库目标定义（示例）
add_library(myLib_myLib
  source/myLib.cxx
)
target_include_directories(myLib_myLib
  PUBLIC
    $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/include>
    $<INSTALL_INTERFACE:include>
)
# 使用命名空间目标链接依赖
target_link_libraries(myLib_myLib
  PUBLIC
    myDependency::myDependency
)

# -------------------主库导出配置-------------------
install(TARGETS myLib_myLib
  EXPORT myLibTargets
  LIBRARY DESTINATION lib
  ARCHIVE DESTINATION lib
  RUNTIME DESTINATION bin
  INCLUDES DESTINATION include
)

install(DIRECTORY include/
  DESTINATION include
)

install(EXPORT myLibTargets
  FILE myLibTargets.cmake
  NAMESPACE myLib::
  DESTINATION lib/cmake/myLib
)

# 生成主库配置文件（可选），并在配置文件中导入myDependency
include(CMakePackageConfigHelpers)
write_basic_package_version_file(
  "${CMAKE_CURRENT_BINARY_DIR}/myLibConfigVersion.cmake"
  VERSION 1.0.0
  COMPATIBILITY SameMajorVersion
)

# 创建myLibConfig.cmake.in，添加依赖导入：
# include("${CMAKE_CURRENT_LIST_DIR}/myLibTargets.cmake")
# find_package(myDependency REQUIRED)
configure_package_config_file(
  "${CMAKE_CURRENT_SOURCE_DIR}/myLibConfig.cmake.in"
  "${CMAKE_CURRENT_BINARY_DIR}/myLibConfig.cmake"
  INSTALL_DESTINATION lib/cmake/myLib
)

install(FILES
  "${CMAKE_CURRENT_BINARY_DIR}/myLibConfig.cmake"
  "${CMAKE_CURRENT_BINARY_DIR}/myLibConfigVersion.cmake"
  DESTINATION lib/cmake/myLib
)

完成以上修改后，CMake在导出myLibTargets时就能找到myDependency的导出元数据，错误即可解决。

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