IMPORTED_GLOBAL

在 3.11 版本中新增。

指示 IMPORTED 目標 是否為全域可見。

對於使用 IMPORTED GLOBAL 選項，透過 add_executable() 或 add_library() 建立的目標，此屬性的布林值為 True。對於專案內建置的目標，此值始終為 False。

對於使用 IMPORTED 選項，透過 add_executable() 或 add_library() 建立，但沒有額外的 GLOBAL 選項的目標，此值也為 False。然而，將此屬性設定為 True 可以將此類本地 IMPORTED 目標提升到全域範圍。此提升只能在最初建立 IMPORTED 目標的同一個目錄中進行。

注意

一旦導入的目標被設定為全域，就無法再改回非全域。因此，如果專案設定此屬性，它只能提供 True 的值。如果專案嘗試將屬性設定為非 True 的值，即使該值已經是 False，CMake 也會發出錯誤。

注意

在將 IMPORTED 目標 從 LOCAL 提升到 GLOBAL 之前建立的本地 ALIAS 目標，會保留其初始範圍 (請參閱 ALIAS_GLOBAL 目標屬性)。