LINK_OPTIONS
Новое в версии 3.13.
Список параметров для использования в шаге компоновки общих библиотек, модулей и исполняемых файлов, а также в шаге компоновки устройства. Целевые файлы, которые являются статическими библиотеками, должны использовать свойство цели STATIC_LIBRARY_OPTIONS.
Эти параметры используются как для обычной компоновки, так и для компоновки устройства (см. политику CMP0105). Для управления параметрами компоновки для шагов обычной и компоновки устройства можно использовать $<HOST_LINK> и $<DEVICE_LINK> generator expressions.
Это свойство содержит список параметров, разделенных точкой с запятой, которые были указаны до сих пор для данной цели. Для добавления дополнительных параметров используйте команду target_link_options().
Это свойство инициализируется свойством директории LINK_OPTIONS при создании целевого файла и используется генераторами для установки параметров для компилятора.
Содержание LINK_OPTIONS может использовать «выражения генератора» с синтаксисом $<...>. См. руководство cmake-generator-expressions(7) для доступных выражений. См. руководство cmake-buildsystem(7) для получения дополнительной информации о определении свойств системы сборки.
Примечание
Это свойство должно использоваться в приоритете над свойством LINK_FLAGS.
Параметры компоновки для хоста и устройства
Новое в версии 3.18: Когда участвует шаг компоновки устройства, управляемый свойствами CUDA_SEPARABLE_COMPILATION и CUDA_RESOLVE_DEVICE_SYMBOLS и политикой CMP0105, необработанные параметры будут переданы шагам компоновки хоста и устройства (внутри -Xcompiler или аналогичного для компоновки устройства). Параметры, обернутые $<DEVICE_LINK:...> generator expression, будут использоваться только для шага компоновки устройства. Параметры, обернутые $<HOST_LINK:...> generator expression, будут использоваться только для шага компоновки хоста.
Уникализация параметров
Конечный набор параметров, используемых для целевого файла, строится путем накопления параметров текущего целевого файла и требований к использованию его зависимостей. Набор параметров уникализируется для предотвращения повторений.
Новое в версии 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:, не поддерживается.
© 2000–2022 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.23/prop_tgt/LINK_OPTIONS.html
