add_link_options

Новое в версии 3.13.

Добавляет параметры к шагу линковки для исполняемых файлов, динамических библиотек или библиотек модулей в текущем каталоге и ниже, которые добавляются после вызова этой команды.

add_link_options(<option> ...)

Эта команда может быть использована для добавления любых параметров линковки, но существуют альтернативные команды для добавления библиотек (target_link_libraries() или link_libraries()). См. документацию по свойствам directory и target 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: удаляется, и остальная часть строки параметров анализируется в режиме 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" превращается в -Xlinker -z -Xlinker defs для Clang и -Wl,-z,defs для GNU GCC.

Префикс LINKER: может быть указан как часть выражения префикса SHELL:.

Префикс LINKER: поддерживает альтернативный синтаксис указания аргументов с использованием префикса SHELL: и пробела в качестве разделителя. Тогда предыдущий пример превращается в "LINKER:SHELL:-z defs".

Примечание

Указание префикса SHELL: в любом месте, кроме начала префикса LINKER: не поддерживается.

См. также

link_libraries()
target_link_libraries()
target_link_options()
CMAKE_<LANG>_FLAGS и CMAKE_<LANG>_FLAGS_<CONFIG> добавляют языковые флаги, передаваемые во все вызовы компилятора. Это включает вызовы, которые выполняют компиляцию и те, которые выполняют линковку.

© 2000–2024 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.27/command/add_link_options.html