IMPORTED_GLOBAL

Добавлено в версии 3.11.

Указывает, видна ли глобально цель IMPORTED.

Значение этого свойства равно True для целей, созданных с параметрами IMPORTED GLOBAL команды add_executable() или add_library(). Для целей, собираемых в рамках проекта, оно всегда равно False.

Для целей, созданных с параметром IMPORTED команды add_executable() или add_library(), но без дополнительного параметра GLOBAL, это значение также равно False. Однако установка этого свойства в True для такой локальной цели IMPORTED переводит её в глобальную область видимости. Такое преобразование можно выполнить только в том же каталоге, где изначально была создана эта цель IMPORTED.

Примечание

После того как импортированная цель стала глобальной, её нельзя снова сделать неглобальной. Поэтому, если проект задаёт это свойство, он может указать только значение True. CMake выдаст ошибку, если проект попытается задать свойству значение, отличное от True, даже если его прежнее значение уже было False.

Примечание

Локальные цели ALIAS, созданные до перевода цели IMPORTED из LOCAL в GLOBAL, сохраняют исходную область видимости (см. свойство цели ALIAS_GLOBAL).

© 2000–2026 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/latest/prop_tgt/IMPORTED_GLOBAL.html