CMake配置中公共链接接口依赖与find_dependency使用疑问

当客户端调用find_package引入一个公共链接接口包含Qt依赖的库时，出现如下CMake错误：

CMake Error at /albert-targets.cmake:47 (set_target_properties):
The link interface of target "albert::albert" contains:

Qt6::Concurrent

but the target was not found. Possible reasons include:

* There is a typo in the target name.
* A find_package call is missing for an IMPORTED target.
* An ALIAS target is missing.

Call Stack (most recent call first):
/albert-config.cmake:30 (include)
CMakeLists.txt:3 (find_package)

疑问：

• 是否需要在CMake配置文件中为公共链接接口的库添加find_dependency？
• 如果已在配置文件中调用find_dependency，为何还要将这些库放入公共链接接口？
• 公共链接接口是否多余？毕竟调用find_dependency后，依赖是公共还是私有对客户端似乎没有区别。

1. 必须添加find_dependency #

是的，你必须在库的albert-config.cmake中添加find_dependency(Qt6 COMPONENTS Concurrent)。CMake的导出目标机制要求：当导出目标的链接接口包含其他导入目标时，必须确保这些目标在客户端执行find_package(albert)时已被正确查找并加载。你遇到的错误本质是客户端环境中不存在Qt6::Concurrent目标，而你的配置文件未帮客户端完成这个依赖的查找流程。

2. 公共链接接口绝非多余 #

即便调用了find_dependency，将依赖放入公共链接接口依然有不可替代的作用：

• 传递编译/链接属性：公共依赖会把自身的编译选项、宏定义、头文件目录等传递给客户端目标。比如Qt6::Concurrent可能附带特定的编译标志，客户端链接你的库时必须拿到这些标志才能正确编译。
• 版本与组件一致性：确保客户端使用的Qt版本与你的库编译时依赖的版本匹配，避免因版本差异引发的未定义符号、行为异常等兼容性问题。
• 隐式依赖传递：如果客户端目标需要直接使用Qt6::Concurrent的API，公共链接接口会自动让客户端目标链接到该依赖，无需客户端手动调用target_link_libraries。

3. 公共与私有依赖的核心区别 #

find_dependency仅负责让CMake找到依赖的目标，但公共和私有依赖对客户端的影响完全不同：

• 私有依赖：仅你的库自身需要该依赖，客户端目标不会继承其链接属性，也无法访问该依赖的目标。如果你的库只是内部使用Qt6::Concurrent，对外接口未用到它的类型或符号，就可以将其设为私有。
• 公共依赖：客户端目标会继承该依赖的所有链接属性，且CMake会确保该依赖在客户端构建过程中可见。如果你的库的公共头文件中用到了Qt6::Concurrent的类型（比如QFuture），必须将其设为公共依赖，否则客户端编译时会找不到这些类型的定义。

简言之，find_dependency解决的是「依赖能不能被找到」的问题，而公共链接接口解决的是「依赖的属性能不能正确传递给客户端」的问题，两者各司其职，缺一不可。

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