LINKER_TYPE

在版本 3.29 中添加。

指定链接步骤中将使用的链接器。属性值可以使用 生成器表达式

注意

假定指定的链接器与编译器通常调用的默认链接器完全兼容。CMake 不会进行任何选项翻译。

链接器类型区分大小写,且只能包含字母、数字和下划线。全大写定义的链接器类型保留给 CMake 自己的内置类型。预定义的链接器类型有:

DEFAULT

此类型对应标准链接,本质上等同于未设置 LINKER_TYPE 目标属性。

SYSTEM

使用平台或工具链提供的标准链接器。例如,这对于所有与 MSVC 兼容的编译器都意味着使用 Microsoft 链接器。此类型支持以下平台-编译器组合:

  • Linux:GNUClangLLVMFlangNVIDIASwift 编译器。

  • Apple 平台:AppleClangClangGNUSwift 编译器。

  • Windows:MSVCGNUClangNVIDIASwift 编译器。

LLD

使用 LLVM 链接器。此类型支持以下平台-编译器组合:

  • Linux:GNUClangLLVMFlangNVIDIASwift 编译器。

  • Apple 平台:ClangAppleClangSwift 编译器。

  • Windows:GNU、使用 MSVC 式前端的 Clang、使用 GNU 式前端的 ClangMSVC、使用 MSVC 式前端的 NVIDIASwift

BFD

使用 GNU 链接器。此类型支持以下平台-编译器组合:

  • Linux:GNUClangLLVMFlangNVIDIA 编译器。

  • Windows:GNU、使用 GNU 式前端的 Clang

GOLD

在 Linux 平台支持 GNUClangLLVMFlangNVIDIASwift 编译器。

MOLD

使用 mold 链接器。此类型支持以下平台-编译器组合:

  • Linux:GNUClangLLVMFlangNVIDIA 编译器。

  • Apple 平台:ClangAppleClang 编译器(作为 sold 链接器 的别名)。

SOLD

使用 sold 链接器。此类型仅在 Apple 平台支持 ClangAppleClang 编译器。

APPLE_CLASSIC

使用 Apple 链接器的经典行为(即 Xcode 15.0 之前的行为)。此类型仅在 Apple 平台支持 GNUClangAppleClangSwift 编译器。

MSVC

使用 Microsoft 链接器。此类型仅在 Windows 平台支持 MSVC、使用 MSVC 式前端的 ClangSwift 编译器。

此属性不支持 Green Hills MULTI 生成器。

所选链接器的实现细节将由 CMAKE_<LANG>_USING_LINKER_<TYPE> 变量提供。例如:

add_library(lib1 SHARED ...)
set_property(TARGET lib1 PROPERTY LINKER_TYPE LLD)

这指定 lib1 应在链接步骤中使用 LLD 链接器类型。将传递给工具链的命令行选项将由 CMAKE_<LANG>_USING_LINKER_LLD 变量提供。

请注意,链接器通常会使用 CMAKE_LINKER_TYPE 来为整个构建设置,而不是为单个目标设置 LINKER_TYPE 属性。