进口_全球

在 3.11 版本加入.

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

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

对于使用 IMPORTED 选项创建的目标:command:add_executable() 或 add_library() 但没有附加选项 GLOBAL 这也是 False。但是，将此类本地“IMPORTED”目标的此属性设置为 True 会将该目标提升到全局范围。此提升只能在最初创建“IMPORTED”目标的同一目录中进行。

备注

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

备注

在将 IMPORTED 目标 从 LOCAL 提升到 GLOBAL 之前创建的本地 ALIAS 目标，保持它们的初始范围（参见 :prop_tgt:` ALIAS_GLOBAL` 目标属性）。