命令简介
为特定的构建目标添加链接目录,具体的命令格式为:
target_link_directories(<target> [BEFORE]
<INTERFACE|PUBLIC|PRIVATE> [items1...]
[<INTERFACE|PUBLIC|PRIVATE> [items2...] ...])
<target>必须是已经通过add_executable()或add_library()等命令创建出来的目标,对于每一个添加的目录,也有可选的范围参数PUBLIC、PRIVATE和INTERFACE,区别是:指定PUBLIC或PRIVATE时,目录会添加到目标的LINK_DIRECTORIES属性中;指定PUBLIC或INTERFACE时,目录会添加到目标的INTERFACE_LINK_DIRECTORIES属性中。和link_directories的主要差别是:
-
link_directories会对当前CMakeLists.txt文件的目标文件生效,并会通过add_subdirectory调用传递到子目录;target_link_directories则针对指定的目标文件生效。
-
target_link_directories对于指定目标添加的目录,INTERFACE和PUBLIC会添加到<target>的INTERFACE_INCLUDE_DIRECTORIES属性,PUBLIC和PRIVATE会添加到<target>的INCLUDE_DIRECTORIES属性中。
默认情况下,会按照追加的方式添加目录,如果指定了参数BEFORE,那么添加的时候会将目录插入到最前面。
示例
目录结构如下:
target_link_directories/
├── CMakeLists.txt
├── lib
│ └── libtest.a
└── main.cpp
CMakeLists.txt文件内容:
cmake_minimum_required(VERSION 3.22)
project(target_link_directories_test)
add_executable(main main.cpp)
target_link_libraries(main test)
target_link_directories(main PRIVATE lib)
执行cmake .
和make VERBOSE=1
以及./main
,结果:
$ ./main
In test: say hello!