IMPORTED_GLOBAL

在版本 3.11 中添加。

指示 IMPORTED 目标 是否全局可见。

对于使用 IMPORTED GLOBAL 选项通过 add_executable() 或 add_library() 创建的目标，此属性的布尔值为 True。对于在项目内构建的目标，此属性始终为 False。

对于使用 IMPORTED 选项通过 add_executable() 或 add_library() 创建但没有额外选项 GLOBAL 的目标，此属性也为 False。但是，将此类本地 IMPORTED 目标的此属性设置为 True 会将该目标提升为全局作用域。此提升只能在最初创建该 IMPORTED 目标的同一目录中完成。

注意

一旦导入的目标被设置为全局，就无法更改回非全局。因此，如果项目设置此属性，则只能提供 True 值。如果项目尝试将该属性设置为非 True 值，即使该值已经为 False，CMake 也会发出错误。

注意

在将 IMPORTED 目标 从 LOCAL 提升为 GLOBAL 之前创建的本地 ALIAS 目标，将保持其初始作用域（请参阅 ALIAS_GLOBAL 目标属性）。