target_link_options

Добавление параметров ссылки к целевому объекту.

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

Укажите параметры ссылки для использования при подключении заданного целевого объекта. Названный <target> объект должен быть создан командой, такой как add_executable() или add_library(), и не должен быть целевым объектом-псевдонимом.

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

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

Ключевые слова 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".