target_link_options

3.13 版本新增。

为可执行文件、共享库或模块库目标添加链接步骤的选项。

target_link_options(<target> [BEFORE]
  <INTERFACE|PUBLIC|PRIVATE> [items1...]
  [<INTERFACE|PUBLIC|PRIVATE> [items2...] ...])

名为 <target> 的目标必须是由 add_executable() 或 add_library() 等命令创建的目标，并且不能是 别名目标。

此命令可用于添加任何链接选项，但存在用于添加库的替代命令（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> 的重复调用将按调用顺序追加条目。

注意

导入的目标 仅支持 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 变量的值给出。

例如，对于 Clang，"LINKER:-z,defs" 会变成 -Xlinker -z -Xlinker defs；对于 GNU GCC，则会变成 -Wl,-z,defs。

LINKER: 前缀可以作为 SHELL: 前缀表达式的一部分指定。

LINKER: 前缀支持使用 SHELL: 前缀和空格作为分隔符来指定参数，作为一种替代语法。前面的示例将变为 "LINKER:SHELL:-z defs"。

注意

不支持在 LINKER: 前缀的开头以外的任何位置指定 SHELL: 前缀。

另请参阅

• target_compile_definitions()

• target_compile_features()

• target_compile_options()

• target_include_directories()

• target_link_libraries()

• target_link_directories()

• target_precompile_headers()

• target_sources()

• CMAKE_<LANG>_FLAGS 和 CMAKE_<LANG>_FLAGS_<CONFIG> 添加传递给编译器所有调用的语言范围标志。这包括驱动编译和驱动链接的调用。

• 模块 CheckLinkerFlag 用于检查编译器是否支持某个链接器标志。