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–2021 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.21/prop_tgt/LINK_OPTIONS.html
