LINK_OPTIONS
Добавлен в версии 3.13.
Список параметров для использования на этапе компоновки общих библиотек, модулей и исполняемых файлов-целей, а также на этапе компоновки устройств. Цели, которые являются статическими библиотеками, должны использовать свойство цели STATIC_LIBRARY_OPTIONS.
Эти параметры используются как для обычной компоновки, так и для компоновки устройств (см. политику CMP0105). Для управления параметрами компоновки для обычного и этапа компоновки устройства можно использовать генераторские выражения $<HOST_LINK> и $<DEVICE_LINK>.
Это свойство содержит список параметров, разделённых точкой с запятой, указанных до сих пор для своей цели. Используйте команду 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:...>, будут использоваться только для этапа компоновки устройства. Параметры, обернутые генераторским выражением $<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: не поддерживается.
© 2000–2024 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/latest/prop_tgt/LINK_OPTIONS.html
