Spec-Zone.ru › CMake 3.22

CMP0079

Новое в версии 3.13.

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

Примечание

Поведение политики OLD deprecated by definition и может быть удалено в будущей версии CMake.

© 2000–2021 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.22/policy/CMP0079.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API