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>. Следующие аргументы задают опции компоновки. Повторные вызовы для одного и того же <target> добавляют элементы в порядке вызова.

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

Опции компоновки для хоста и устройства

Устранение дублирования опций

Конечный набор опций, используемых для целевого объекта, строится путем накопления опций из текущего целевого объекта и требований использования его зависимостей. Набор опций дедублицируется, чтобы избежать повторений.

Обработка различий в компиляторах

Для передачи опций компоновщику каждый компилятор имеет свой собственный синтаксис. Префикс 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".