target_link_options

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

target_link_options(<target> [BEFORE]
  {INTERFACE|PUBLIC|PRIVATE} <item>...
  [{INTERFACE|PUBLIC|PRIVATE} <item>...]...)

Цель <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".

См. также

• target_compile_definitions()
• target_compile_features()
• target_compile_options()
• target_include_directories()
• target_link_libraries()
• target_link_directories()
• target_precompile_headers()
• target_sources()
• CMAKE_<LANG>_FLAGS и CMAKE_<LANG>_FLAGS_<CONFIG> добавляют глобальные для языка флаги, передаваемые при всех вызовах компилятора. Сюда входят вызовы, выполняющие компиляцию, а также вызовы, выполняющие компоновку.

• Добавлено в версии 4.3: CMAKE_<LANG>_LINK_FLAGS и CMAKE_<LANG>_LINK_FLAGS_<CONFIG> добавляют глобальные для языка флаги, передаваемые при всех вызовах компилятора, выполняющих компоновку.

• Модуль CheckLinkerFlag для проверки поддержки флага компоновщика компилятором.