EXCLUDE_FROM_ALL¶
在子目錄上將此目錄屬性設定為 true 值,可將其目標從其父目錄的「all」目標中排除。如果被排除,則在父目錄中執行例如 make
將預設不會建置子目錄的目標。這不會影響子目錄本身的「all」目標。在子目錄內執行例如 make
仍然會建置其目標。
EXCLUDE_FROM_ALL
適用於子目錄包含專案中獨立但非必要的部分時,例如一組範例,或整合的第三方程式庫。通常子目錄應包含其自己的 project()
命令調用,以便在子目錄中產生完整的建置系統(例如 Visual Studio IDE 解決方案檔案)。請注意,目標間的相依性會取代此排除。如果父專案建置的目標依賴於子目錄中的目標,則依賴的目標將包含在父專案的建置系統中以滿足相依性。
如果提供 EXCLUDE_FROM_ALL
參數,則會產生以下效果
在子目錄或下方定義的目標將不會包含在父目錄的
ALL
目標中。這些目標必須由使用者明確建置,或是將被建置的其他目標的相依性。在子目錄或下方定義的目標將從 IDE 專案檔案中排除。
安裝父目錄時,將忽略在子目錄或下方定義的任何安裝規則。
請注意,這些效果與 EXCLUDE_FROM_ALL
目標屬性的效果不同。