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 目標屬性）。