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