EXCLUDE_FROM_ALL

將此目標屬性設定為 true (或 false) 值,以從包含目錄及其上層目錄的 "all" 目標中排除 (或包含) 目標。 如果排除,在包含目錄或其上層目錄中執行例如 make 將預設不會建置目標。

如果未設定此目標屬性,則目標將包含在包含目錄的 "all" 目標中。 此外,除非設定了 EXCLUDE_FROM_ALL 目錄屬性,否則它將包含在其上層目錄的 "all" 目標中。

EXCLUDE_FROM_ALL 設定為 false 或完全未設定時,目標將在執行 make install 或其用於所使用 CMake 產生器的等效操作時更新。

如果目標的 EXCLUDE_FROM_ALL 設定為 true,它仍然可以列在 install(TARGETS) 命令中,但使用者有責任確保在執行安裝時,目標的建置產物不會遺失或過時。

此屬性可以使用語法為 $<...> 的 "產生器表達式"。 有關可用的表達式,請參閱 cmake-generator-expressions(7) 手冊。

只有 "Ninja Multi-Config" 產生器支援依組態而異的屬性值。 對於所有其他產生器,此屬性的值對於所有組態都必須相同。