IMPORTED_GLOBALΒΆ
Added 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
IMPORTED
GLOBAL
options to add_executable()
or
add_library()
. It is always False for targets built within the
project.
For targets created with the IMPORTED
option to
add_executable()
or add_library()
but without the
additional option 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.
Note
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.
Note
Local ALIAS targets created before promoting an
IMPORTED target from LOCAL
to GLOBAL
, keep
their initial scope (see ALIAS_GLOBAL
target property).