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