EXCLUDE_FROM_ALL¶
設定此目標屬性為 true (或 false) 值,以將目標排除 (或包含) 在包含目錄及其上層目錄的 "all" 目標中。如果排除,則在包含目錄或其上層目錄中執行例如 make
時,預設不會建置該目標。
如果未設定此目標屬性,則該目標將包含在包含目錄的 "all" 目標中。此外,它將包含在其上層目錄的 "all" 目標中,除非設定了 EXCLUDE_FROM_ALL
目錄屬性。
當 EXCLUDE_FROM_ALL
設定為 false 或根本未設定時,該目標將在執行 make install
或 CMake 產生器所使用的等效指令時更新。
如果目標的 EXCLUDE_FROM_ALL
設定為 true,它仍然可以列在 install(TARGETS)
命令中,但使用者有責任確保在執行安裝時,目標的建置成品不會遺失或過時。
此屬性可以使用語法 $<...>
的「產生器表達式」。請參閱 cmake-generator-expressions(7)
手冊以取得可用的表達式。
只有 "Ninja Multi-Config" 產生器支援依組態而異的屬性值。對於所有其他產生器,此屬性的值必須在所有組態中相同。