add_link_options

Добавляет параметры к ссылке на общую библиотеку, модуль и исполняемые файлы.

add_link_options(<option> ...)

Добавляет параметры к шагу ссылки для целевых объектов в текущей директории и ниже, которые добавляются после вызова этой команды. См. документацию по directory и target LINK_OPTIONS свойствам.

Эта команда может быть использована для добавления любых параметров, но существуют альтернативные команды для добавления библиотек (target_link_libraries() или link_libraries()).

Аргументы для add_link_options могут использовать «генераторные выражения» со синтаксисом $<...>. См. руководство cmake-generator-expressions(7) для доступных выражений. См. руководство cmake-buildsystem(7) для получения более подробной информации об определении свойств системы сборки.

Конечный набор параметров компиляции или компоновки, используемых для целевого объекта, формируется путем накопления параметров от текущего целевого объекта и требований к его зависимостям. Набор параметров дублируется, чтобы избежать повторений. Хотя это выгодно для отдельных параметров, этап удаления дубликатов может разбить группы параметров. Например, -D A -D B становится -D A B. Можно указать группу параметров, используя оболочечную цитирование вместе с префиксом SHELL:. Префикс SHELL: удаляется, и остальная часть строки параметров анализируется с помощью режима separate_arguments() UNIX_COMMAND. Например, "SHELL:-D A" "SHELL:-D B" становится -D A -D 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".