add_link_options¶
3.13 版本新增。
为当前目录及以下(在调用此命令后添加的)可执行文件、共享库或模块库目标添加链接步骤的选项。
add_link_options(<option> ...)
此命令可用于添加任何链接选项,但存在添加库的替代命令(target_link_libraries() 或 link_libraries())。请参阅 目录 和 目标 的 LINK_OPTIONS 属性文档。
注意
此命令不能用于为静态库目标添加选项,因为它们不使用链接器。要添加归档器或 MSVC 库标志,请参阅 STATIC_LIBRARY_OPTIONS 目标属性。
传递给 add_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 变量的值给出。
例如,对于 Clang,"LINKER:-z,defs" 会变成 -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>添加传递给编译器所有调用的语言范围标志。这包括驱动编译和驱动链接的调用。