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_policy() или cmake_minimum_required(). Если она не установлена, CMake выводит предупреждение и использует поведение OLD.