CMP0079

target_link_libraries() позволяет использовать цели в других каталогах.

До CMake 3.13 команда target_link_libraries() не принимала цели, созданные не в текущем каталоге, в качестве первого аргумента для вызовов, обновляющих свойство LINK_LIBRARIES самой цели. Она случайно принимала цели из других каталогов при вызовах, обновляющих только INTERFACE_LINK_LIBRARIES, но просто добавляла записи в свойство так, как будто вызов был сделан в исходном каталоге. Таким образом, интерфейсные библиотеки, указанные таким образом, всегда находились генераторами в рамках области исходной цели, а не в области, вызвавшей target_link_libraries().

CMake 3.13 теперь позволяет вызывать команду target_link_libraries() из любого каталога, чтобы добавить зависимости компоновки и интерфейсные библиотеки компоновки к целям, созданным в других каталогах. Записи добавляются в LINK_LIBRARIES и INTERFACE_LINK_LIBRARIES с использованием специального (внутреннего) суффикса, чтобы указать генераторам искать имена в области вызова, а не в области, создавшей цель.

Эта политика обеспечивает совместимость с проектами, которые уже используют target_link_libraries() с ключевым словом INTERFACE для цели в другом каталоге, чтобы добавить записи INTERFACE_LINK_LIBRARIES, которые будут искаться в каталоге цели. Такие проекты следует обновить, чтобы учесть новые правила области видимости в этом случае.

Поведение этой политики OLD заключается в запрете вызовов target_link_libraries() с именами целей из другого каталога, за исключением ранее случайно разрешенного случая использования только ключевого слова INTERFACE. Поведение этой политики NEW заключается в разрешении всех таких вызовов, но с использованием новых правил области видимости.

Эта политика была введена в CMake версии 3.13. CMake версии 3.26.0-rc3 выводит предупреждение, когда политика не установлена, и использует поведение OLD. Используйте команду cmake_policy(), чтобы установить её явно в OLD или NEW.