LINK_LIBRARIES_ONLY_TARGETS
Новое в версии 3.23.
Требует, чтобы элементы связей, которые могут быть именами целей, фактически были существующими целями.
Установите это свойство в истинное значение, чтобы включить дополнительные проверки содержимого свойств целей LINK_LIBRARIES и INTERFACE_LINK_LIBRARIES, как правило, заполненные target_link_libraries(). Проверки также применяются к библиотекам, добавленным в цель через свойства зависимостей INTERFACE_LINK_LIBRARIES_DIRECT. 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–2024 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.28/prop_tgt/LINK_LIBRARIES_ONLY_TARGETS.html