target_link_options

Добавление опций к шагу линковки для исполняемого файла, динамической библиотеки или библиотеки модулей.

target_link_options(<target> [BEFORE]
  <INTERFACE|PUBLIC|PRIVATE> [items1...]
  [<INTERFACE|PUBLIC|PRIVATE> [items2...] ...])

Именованный <target> должен быть создан командой, такой как add_executable() или add_library(), и не должен быть целью-псевдонимом.

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

Если BEFORE указано, содержимое будет добавлено в начало свойства, а не в конец.

Ключевые слова INTERFACE, PUBLIC и PRIVATE необходимы для указания области действия последующих аргументов. PRIVATE и PUBLIC элементы будут заполнять свойство LINK_OPTIONS цели <target>. PUBLIC и INTERFACE элементы будут заполнять свойство INTERFACE_LINK_OPTIONS цели <target>. (Импортированные цели поддерживают только INTERFACE элементы.) Следующие аргументы задают опции линковки. Повторные вызовы для одного и того же <target> добавляют элементы в порядке вызова.

Аргументы для target_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".