New in version 3.11.
Indication of whether an IMPORTED target is globally visible.
The boolean value of this property is True for targets created with the
GLOBAL options to
add_library(). It is always False for targets built within the
For targets created with the
IMPORTED option to
add_library() but without the
GLOBAL this is False, too. However, setting this
property for such a locally
IMPORTED target to True promotes that
target to global scope. This promotion can only be done in the same
directory where that
IMPORTED target was created in the first place.
Once an imported target has been made global, it cannot be changed back to non-global. Therefore, if a project sets this property, it may only provide a value of True. CMake will issue an error if the project tries to set the property to a non-True value, even if the value was already False.
Local ALIAS targets created before promoting an
IMPORTED target from
their initial scope (see
ALIAS_GLOBAL target property).