target_link_options¶
3.13 版本新增。
为可执行文件、共享库或模块库目标添加链接步骤选项。
target_link_options(<target> [BEFORE]
<INTERFACE|PUBLIC|PRIVATE> [items1...]
[<INTERFACE|PUBLIC|PRIVATE> [items2...] ...])
指定的 <target>
必须已通过诸如 add_executable()
或 add_library()
等命令创建,并且不能是 ALIAS target。
此命令可用于添加任何链接选项,但存在其他命令用于添加库(target_link_libraries()
或 link_libraries()
)。请参阅 directory
和 target
LINK_OPTIONS
属性的文档。
注意
此命令不能用于为静态库目标添加选项,因为它们不使用链接器。要添加归档器或 MSVC 库管理员标志,请参阅 STATIC_LIBRARY_OPTIONS
目标属性。
如果指定了 BEFORE
,则内容将添加到属性的开头而不是末尾。
关键字 INTERFACE
、PUBLIC
和 PRIVATE
用于指定后续参数的 作用域。PRIVATE
和 PUBLIC
项将填充 <target>
的 LINK_OPTIONS
属性。PUBLIC
和 INTERFACE
项将填充 <target>
的 INTERFACE_LINK_OPTIONS
属性。后续参数指定链接选项。对同一个 <target>
重复调用将按调用顺序添加项。
注意
IMPORTED targets 仅支持 INTERFACE
项。
target_link_options
的参数可以使用 $<...>
语法的生成器表达式。有关可用表达式,请参阅 cmake-generator-expressions(7)
手册。有关定义构建系统属性的更多信息,请参阅 cmake-buildsystem(7)
手册。
主机和设备特定链接选项¶
版本 3.18 新增: 当涉及设备链接步骤时,由 CUDA_SEPARABLE_COMPILATION
和 CUDA_RESOLVE_DEVICE_SYMBOLS
属性以及策略 CMP0105
控制,原始选项将传递给主机和设备链接步骤(对于设备链接,封装在 -Xcompiler
或等效项中)。使用 $<DEVICE_LINK:...>
生成器表达式封装的选项将仅用于设备链接步骤。使用 $<HOST_LINK:...>
生成器表达式封装的选项将仅用于主机链接步骤。
选项去重¶
用于目标的最终选项集通过累积当前目标及其依赖项的使用要求的选项来构建。选项集经过去重以避免重复。
版本 3.12 新增: 尽管对单个选项有益,但去重步骤可能会破坏选项组。例如,-option A -option B
变为 -option A B
。可以使用类似 shell 的引用和 SHELL:
前缀来指定一组选项。SHELL:
前缀被删除,选项字符串的其余部分使用 separate_arguments()
的 UNIX_COMMAND
模式进行解析。例如,"SHELL:-option A" "SHELL:-option B"
变为 -option A -option B
。
处理编译器驱动器差异¶
要将选项传递给链接器工具,每个编译器驱动程序都有自己的语法。LINKER:
前缀和 ,
分隔符可以用来以可移植的方式指定要传递给链接器工具的选项。LINKER:
被适当的驱动程序选项替换,,
被适当的驱动程序分隔符替换。驱动程序前缀和驱动程序分隔符由 CMAKE_<LANG>_LINKER_WRAPPER_FLAG
和 CMAKE_<LANG>_LINKER_WRAPPER_FLAG_SEP
变量的值给出。
例如,"LINKER:-z,defs"
对于 Clang
变为 -Xlinker -z -Xlinker defs
,对于 GNU GCC
变为 -Wl,-z,defs
。
LINKER:
前缀可以作为 SHELL:
前缀表达式的一部分指定。
LINKER:
前缀支持另一种语法,即使用 SHELL:
前缀和空格作为分隔符来指定参数。前面的示例将变为 "LINKER:SHELL:-z defs"
。
注意
不支持在 LINKER:
前缀的开头以外的任何位置指定 SHELL:
前缀。
另请参阅¶
CMAKE_<LANG>_FLAGS
和CMAKE_<LANG>_FLAGS_<CONFIG>
添加语言范围的标志,这些标志传递给编译器的所有调用,包括驱动编译和驱动链接的调用。CheckLinkerFlag
模块用于检查编译器是否支持某个链接器标志。