CMake传递依赖处理问题：SHARED与INTERFACE库差异咨询

问题根源 #

你的错误本质是：my_package的导出配置文件（my_packageConfig.cmake）没有自动引入它依赖的foo和bar包。当my_program通过find_package(my_package)引入目标时，CMake能找到MyNamespace::my_package，但该目标的链接接口中引用的MyNamespace::foo和MyNamespace::bar并未被加载到当前CMake环境中，因此报错。

CMake通过install(EXPORT)生成的目标导出文件仅记录当前目标的属性，不会自动添加依赖包的find_package逻辑，必须手动处理传递依赖。

正确解决方案 #

要让my_package的依赖能自动传递给上层项目，需要为my_package编写配置模板文件，并在其中使用CMake提供的find_dependency宏引入依赖包。

步骤1：创建my_packageConfig.cmake.in模板 #

在my_package目录下新建my_packageConfig.cmake.in文件，内容如下：

@PACKAGE_INIT@

# 自动引入依赖的foo和bar包
find_dependency(foo)
find_dependency(bar)

# 导入my_package的目标定义
include("${CMAKE_CURRENT_LIST_DIR}/my_packageTargets.cmake")

@PACKAGE_INIT@是CMake的变量替换标记，会在配置时自动填充包初始化逻辑；find_dependency是专门为传递依赖设计的宏，它会继承上层find_package的参数（如REQUIRED），并确保依赖包被正确加载。

步骤2：修改my_package的CMakeLists.txt #

将原来直接把导出目标文件命名为Config.cmake的逻辑拆分，分别安装目标导出文件和配置文件：

# 安装目标导出文件（命名为Targets.cmake，而非Config.cmake）
install(
    EXPORT ${PROJECT_NAME}Targets
    FILE ${PROJECT_NAME}Targets.cmake
    NAMESPACE MyNamespace::
    DESTINATION lib/cmake/${PROJECT_NAME}
    COMPONENT staging
)

# 配置模板文件生成最终的Config.cmake
configure_file(
    ${PROJECT_SOURCE_DIR}/my_packageConfig.cmake.in
    ${PROJECT_BINARY_DIR}/my_packageConfig.cmake
    @ONLY
)

# 安装配置文件
install(
    FILES ${PROJECT_BINARY_DIR}/my_packageConfig.cmake
    DESTINATION lib/cmake/${PROJECT_NAME}
    COMPONENT staging
)

步骤3：验证其他包的配置（可选） #

检查foo和bar的配置是否符合规范：

• foo作为SHARED库，其install(EXPORT)生成的fooConfig.cmake能被find_package(foo)正确识别，无需修改。
• bar作为INTERFACE库，install(TARGETS)中的ARCHIVE和LIBRARY可以删除（因为INTERFACE库无实体产物），不影响功能，但更简洁：

  install(
      TARGETS ${PROJECT_NAME}
      EXPORT ${PROJECT_NAME}Targets
      COMPONENT staging
  )
  

SHARED库与INTERFACE库的依赖处理差异 #

两者的核心差异在于依赖属性的传递方式，但传递依赖的配置逻辑是一致的：

1. SHARED库：
   • 是编译生成的实体库，其PUBLIC/INTERFACE级别的依赖会被记录到目标的INTERFACE_LINK_LIBRARIES属性中。
   • 当其他目标链接该SHARED库时，CMake会尝试传递这些依赖，但前提是依赖的目标已被加载到当前环境（即需要find_dependency提前引入）。
2. INTERFACE库：
   • 无实体编译产物，所有属性（包含目录、链接库等）都是INTERFACE级别的。
   • 当目标链接INTERFACE库时，会直接继承其所有INTERFACE属性，包括依赖的其他库。但同样需要在INTERFACE库的Config.cmake中用find_dependency引入其依赖，否则上层项目会找不到这些依赖目标。

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