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.23.3 предупреждает, когда политика не задана, и использует поведение OLD. Используйте команду cmake_policy(), чтобы установить её явно в OLD или NEW.