LINK_LIBRARIES_ONLY_TARGETS

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

Задайте для этого свойства значение true, чтобы включить дополнительные проверки содержимого свойств целевых объектов 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.