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" 產生器支援依組態而異的屬性值。 對於所有其他產生器,此屬性的值對於所有組態都必須相同。