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