target_link_options

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

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

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

Эта команда может быть использована для добавления любых параметров компоновки, но существуют альтернативные команды для добавления библиотек (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".