IMPORTED_GLOBAL — CMake 3.25.2 Documentation

# IMPORTED_GLOBAL

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 `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).