Spec-Zone.ru › CMake 3.23

LINK_LIBRARIES_ONLY_TARGETS

Новое в версии 3.23.

Требует, чтобы элементы связи, которые могут быть именами целей, фактически были существующими целями.

Установите это свойство в значение true, чтобы включить дополнительные проверки содержимого свойств цели LINK_LIBRARIES и INTERFACE_LINK_LIBRARIES, которые обычно заполняются target_link_libraries(). CMake проверит, что элементы связи, которые могут быть именами целей, на самом деле называют существующие цели. Элемент считается возможным именем цели, если:

  • он не содержит / или \, и
  • он не начинается с -, и
  • (по историческим причинам) он не начинается с $ или `.

Это свойство инициализируется значением переменной CMAKE_LINK_LIBRARIES_ONLY_TARGETS при создании неимпортированной цели. Свойство может быть явно включено для импортированной цели, чтобы проверить ее интерфейс связи.

В следующем примере CMake остановится с ошибкой во время настройки, потому что miLib не является целью:

set(CMAKE_LINK_LIBRARIES_ONLY_TARGETS ON)
add_library(myLib STATIC myLib.c)
add_executable(myExe myExe.c)
target_link_libraries(myExe PRIVATE miLib) # typo for myLib

Для того, чтобы связать библиотеки, предоставляемые инструментом построения, по имени, сохраняя при этом LINK_LIBRARIES_ONLY_TARGETS, используйте импортированную библиотеку интерфейса со свойством цели IMPORTED_LIBNAME:

add_library(toolchain::m INTERFACE IMPORTED)
set_property(TARGET toolchain::m PROPERTY IMPORTED_LIBNAME "m")
target_link_libraries(myExe PRIVATE toolchain::m)

См. также политику CMP0028.

Примечание

Если INTERFACE_LINK_LIBRARIES содержит выражения генератора, ее фактический список элементов связи может зависеть от типа и свойств целевой области. В таких случаях CMake не всегда может обнаруживать имена отсутствующих целей, которые появляются только для определенных потребителей. Будущая версия CMake с улучшенными эвристиками может начать вызывать ошибки в проектах, принятых предыдущими версиями CMake.

© 2000–2022 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.23/prop_tgt/LINK_LIBRARIES_ONLY_TARGETS.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API