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