CMake中link_directories/target_link_directories的使用
CMake中的link_directories命令用于添加目录使链接器能在其查找库(add directories in which the linker will look for libraries),其格式如下:
link_directories([AFTER|BEFORE] directory1 [directory2 ...])
添加路径使链接器应在其中搜索库。提供给此命令的相对路径被解释为相对于当前源目录。
该命令只适用于在它被调用后创建的target。
这些目录将添加到当前CMakeLists.txt文件的LINK_DIRECTORIES目录属性中,并根据需要将相对路径转换为绝对路径。
默认情况下,指定的目录将追加到当前目录列表中。可以通过将CMAKE_LINK_DIRECTORIES_BEFORE设置为ON来更改此默认行为。通过显式使用AFTER或BEFORE,你可以在追加和前置之间(between appending and prepending)进行选择,而与默认值无关。
link_directories的参数可以使用语法为"$<...>"的"生成器表达式"。
注意:此命令很少是必需的,在有其它选择的情况下应避免使用。在可能的情况下,最好将完整的绝对路径传递给库,因为这可确保始终链接正确的库。find_library命令提供完整路径,通常可以直接用于调用target_link_libraries命令。可能需要库搜索路径的情况包括:
(1).像Xcode这样的项目生成器(project generators),用户可以在构建时切换目标架构(target architecture),但不能使用库的完整路径,因为它只提供一种架构(即它不是通用的二进制文件)。
(2).库本身可能还有其它通过RPATH机制找到的私有库依赖项,但是某些链接器无法完全解码这些路径(例如,由于存在$ORIGIN之类的东西)。
如果必须提供库搜索路径,则最好尽可能使用target_link_directories命令,而不是link_directories命令来本地化效果。特定于target的命令还可以控制搜索目录如何传播到其它依赖targets。
link_directories(/A)
link_directories(BEFORE /B)
set(CMAKE_LINK_DIRECTORIES_BEFORE ON)
link_directories(/C)get_directory_property(result LINK_DIRECTORIES)
message("result: ${result}") # result: /C;/B;/Aadd_executable(main EXCLUDE_FROM_ALL samples/sample_subtraction.cpp)
target_include_directories(main PUBLIC include)add_library(subtraction SHARED source/subtraction.cpp)
target_include_directories(subtraction PUBLIC include)target_link_libraries(main subtraction)get_target_property(result2 main LINK_DIRECTORIES)
message("result2: ${result2}") # result2: /C;/B;/A
CMake中的target_link_directories命令用于将链接目录添加到target,其格式如下:
target_link_directories(<target> [BEFORE]<INTERFACE|PUBLIC|PRIVATE> [items1...][<INTERFACE|PUBLIC|PRIVATE> [items2...] ...])
指定链接器在链接给定target时应在其中搜索库的路径。每项(each item)可以是绝对路径或相对路径,后者被解释为相对于当前源目录。这些项将被添加到链接命令中。
命名的<target>必须由诸如add_executable或add_library之类的命令创建,并且不能为ALIAS target。
需要INTERFACE, PUBLIC和PRIVATE关键字来指定它们后面的项的作用域(scope).PRIVATE和PUBLIC项将填充<target>的LINK_DIRECTORIES属性。PUBLIC和INTERFACE项将填充<target>的INTERFACE_LINK_DIRECTORIES属性(IMPORTED targets仅支持INTERFACE项)。每个项指定一个链接目录,如有必要,在将其添加到相关属性之前,将转换为绝对路径。重复调用相同的<target>会按调用顺序追加项。
如果指定BEFORE,则内容(content)将被添加到相关属性的前面,而不是被追加。
target_link_directories的参数可以使用语法为$<...>的"生成器表达式"。
注意:此命令很少是必需的,在有其它选择的情况下应避免使用。在可能的情况下,最好将完整的绝对路径传递给库,因为这可确保始终链接正确的库。find_library命令提供完整路径,通常可以直接用于调用target_link_libraries命令。可能需要库搜索路径的情况包括:
(1).像Xcode这样的项目生成器(project generators),用户可以在构建时切换目标架构(target architecture),但不能使用库的完整路径,因为它只提供一种架构(即它不是通用的二进制文件)。
(2).库本身可能还有其它通过RPATH机制找到的私有库依赖项,但是某些链接器无法完全解码这些路径(例如,由于存在$ORIGIN之类的东西)。
add_executable(main EXCLUDE_FROM_ALL samples/sample_subtraction.cpp)
target_include_directories(main PUBLIC include)add_library(subtraction SHARED EXCLUDE_FROM_ALL source/subtraction.cpp)
target_include_directories(subtraction PUBLIC include)target_link_libraries(main subtraction)target_link_directories(main PRIVATE /private/dir INTERFACE /interface/dir)
get_target_property(result main LINK_DIRECTORIES)
message("result: ${result}") # result: /private/dir
get_target_property(result main INTERFACE_LINK_DIRECTORIES)
message("result: ${result}") # result: /interface/dirtarget_link_directories(subtraction PUBLIC /public/dir INTERFACE /interface/dir)
get_target_property(result subtraction LINK_DIRECTORIES)
message("reuslt: ${result}") # reuslt: /public/dir# test no items
target_link_directories(main PRIVATE)
执行测试代码需要多个文件:
build.sh内容如下:
#! /bin/bash# supported input parameters(cmake commands)
params=(function macro cmake_parse_arguments \find_library find_path find_file find_program find_package \cmake_policy cmake_minimum_required project include \string list set foreach message option if while return \math file configure_file \include_directories add_executable add_library target_link_libraries install \target_sources add_custom_command add_custom_target \add_subdirectory aux_source_directory \set_property set_target_properties define_property \add_definitions target_compile_definitions target_compile_features \add_compile_options target_include_directories link_directories)usage()
{echo "Error: $0 needs to have an input parameter"echo "supported input parameters:"for param in ${params[@]}; doecho " $0 ${param}"doneexit -1
}if [ $# != 1 ]; thenusage
fiflag=0
for param in ${params[@]}; doif [ $1 == ${param} ]; thenflag=1breakfi
doneif [ ${flag} == 0 ]; thenecho "Error: parameter \"$1\" is not supported"usageexit -1
fiif [[ ! -d "build" ]]; thenmkdir buildcd build
elsecd build
fiecho "==== test $1 ===="# test_set.cmake: cmake -DTEST_CMAKE_FEATURE=$1 --log-level=verbose ..
# test_option.cmake: cmake -DTEST_CMAKE_FEATURE=$1 -DBUILD_PYTORCH=ON ..
cmake -DTEST_CMAKE_FEATURE=$1 ..
# It can be executed directly on the terminal, no need to execute build.sh, for example: cmake -P test_set.cmake
make
# make install # only used in cmake files with install command
主CMakeLists.txt内容如下:
cmake_minimum_required(VERSION 3.22)
project(cmake_feature_usage)message("#### current cmake version: ${CMAKE_MAJOR_VERSION}.${CMAKE_MINOR_VERSION}.${CMAKE_PATCH_VERSION}")
include(test_${TEST_CMAKE_FEATURE}.cmake)
message("==== test finish ====")
test_link_directories.cmake内容为上面的所有测试代码段
另外还包括三个目录:include,source,samples,它们都是非常简单的实现,仅用于测试,如下:
可能的执行结果如下图所示:
GitHub: https://github.com/fengbingchun/Linux_Code_Test
CMake中link_directories/target_link_directories的使用相关推荐
- CMake中target_compile_features的使用
CMake中的target_compile_features命令用向target添加预期的编译器功能(compiler features),其格式如下: target_compile_features ...
- cmake(二十七)Cmake中target再理解
cmake翻译手册详解 cmake FAQ问题 一 目录结构 ++++++++++++++目录结构-->'最佳实践'++++++++++++++1)对于一个优秀的程序员而言,不仅仅是'编写 ...
- CMake中add_compile_options/target_compile_options的使用
CMake中的add_compile_options命令用于向源文件的编译添加选项,其格式如下: add_compile_options(<option> ...) 将选项添加到COMPI ...
- coverage 覆盖多个测试文件时_奇技淫巧[2]:cmake中添加lcov代码覆盖测试
奇技淫巧[2]:cmake中添加lcov代码覆盖测试 1 目的 为CMake工程的test添加lcov代码覆盖性测试 2 要点 添加lcov支持的方法应该有很多,比较方便的有: (1)利用脚本基于文件 ...
- CMake 中的 PUBLIC,PRIVATE,INTERFACE
一.概述 CMake中经常会使用 target_**() 相关命令,target_**() 命令支持通过 PUBLIC,PRIVATE 和 INTERFACE 关键字来控制传播.本文主要介绍下这三个关 ...
- cmake中的变量和命令的大小写
1 cmake中要特别注意命令和变量的大小写 2 cmake的内置命令是不区分大小写的 3 cmake内置变量是区分大小写的,或者干脆就说,cmake的所有变量都是区分大小写的 这就是变量和命令的不同 ...
- CMake中的ARGC ARGV 和ARGN参数意义
编写或者查看一些开源cmake文件中经常遇到在宏(macro)和函数中经常会遇到ARGC ARGV 和ARGN等参数,该参数为cmake中专用变量,分别表示宏或者函数参数中的特殊意义. ARGC AR ...
- CMake中file的使用
CMake中的file命令用于文件操作,其文件格式如下:此命令专用于需要访问文件系统的文件和路径操作 Readingfile(READ <filename> <variable> ...
- CMake中foreach的使用
CMake中的foreach命令为list中的每个值评估一组命令(Evaluate a group of commands for each value in a list),其格式如下:其中< ...
最新文章
- 马斯克活猪脑机接口试验成功!多芯片植入,硬币大小,实时读取脑电波,已被批准人脑实验...
- js中各种跨域问题实战小结
- 《Linux防火墙(第4版)》——1.3 传输层机制
- [转载]c#中 uint--byte[]--char[]--string相互转换汇总
- MySQL的4大版本
- ORACLE基本SQL语句-查询篇
- Linux学习 - 常用和不太常用的实用awk命令
- 列表的修改,复制,遍历,嵌套和查询
- 谁说数据分析很难?看完这7大分析套路后,还学不会的来找我
- putty远程登录linux无ssh,收集的linux远程ssh连接putty失败解决办法!
- 6.Nginx 的 Rewrite 规则
- 五笔字根表识别码图_86版五笔字根表及口诀(最新图文版)
- android虚拟机运行app出现错误Unfortunately
- 代码打字速度_使用VueJS创建打字速度效果
- IOS免签支持在线封装app分发源码 免签封装带绿标
- python汽车租赁程序_python数据分析实例:共享单车租用影响因素探索
- 怎么写好一份数据分析报告
- 关于Could not find QtWebEngineProcess.exe 进程已结束,退出代码 -1073740791 (0xC0000409) 问题
- Grafana变量介绍
- venus反光柱建图记录