CMake命令之target_link_directories简介

命令简介

为特定的构建目标添加链接目录,具体的命令格式为:

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!
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容