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 для поиска в директории цели. Такие проекты должны быть обновлены, чтобы учитывать новые правила области видимости в этом случае.

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

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