target_link_directories¶
3.13 版本新增。
为目标添加链接目录。
target_link_directories(<target> [BEFORE]
<INTERFACE|PUBLIC|PRIVATE> [items1...]
[<INTERFACE|PUBLIC|PRIVATE> [items2...] ...])
指定链接器在链接给定目标时应搜索库的路径。每个项可以是绝对路径或相对路径,后者被解释为相对于当前源目录。这些项将被添加到链接命令中。
命名的 <target>
必须通过 add_executable()
或 add_library()
等命令创建,并且不能是 ALIAS target。
需要 INTERFACE
、PUBLIC
和 PRIVATE
关键字来指定其后项的范围。PRIVATE
和 PUBLIC
项将填充 <target>
的 LINK_DIRECTORIES
属性。PUBLIC
和 INTERFACE
项将填充 <target>
的 INTERFACE_LINK_DIRECTORIES
属性(IMPORTED targets 仅支持 INTERFACE
项)。每个项都指定一个链接目录,并在必要时将其转换为绝对路径,然后将其添加到相关属性中。对同一 <target>
的重复调用将按调用顺序追加项。
如果指定了 BEFORE
,则内容将预置到相关属性中,而不是追加。
target_link_directories
的参数可以使用语法 $<...>
的生成器表达式。有关可用表达式,请参阅 cmake-generator-expressions(7)
手册。有关定义构建系统属性的更多信息,请参阅 cmake-buildsystem(7)
手册。
注意
此命令很少必要,在有其他选择时应避免使用。尽可能优先传递库的完整绝对路径,因为这能确保始终链接正确的库。find_library()
命令提供完整路径,通常可以直接在调用 target_link_libraries()
时使用。可能需要库搜索路径的情况包括:
像
Xcode
这样的项目生成器,用户可以在构建时切换目标架构,但不能使用库的完整路径,因为它只提供一个架构(即它不是通用二进制文件)。库本身可能还有其他私有库依赖项,这些依赖项期望通过
RPATH
机制找到,但有些链接器无法完全解码这些路径(例如,由于存在$ORIGIN
之类的内容)。