IMPORTED_GLOBAL

3.11 版本新增。

指示 导入目标 是否全局可见。

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

对于通过 add_executable() 或 add_library() 的 IMPORTED 选项创建，但没有附加 GLOBAL 选项的目标，此属性也为 False。但是，为这样本地的 IMPORTED 目标设置此属性为 True 会将该目标提升到全局作用域。此提升只能在创建该 IMPORTED 目标所在的同一目录中进行。

注意

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

注意

在将导入的目标从 LOCAL 提升为 GLOBAL 之前创建的本地 别名目标 会保留其初始作用域（参见 ALIAS_GLOBAL 目标属性）。