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".