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