add_subdirectory

將子目錄加入到建置中。

add_subdirectory(source_dir [binary_dir] [EXCLUDE_FROM_ALL] [SYSTEM])

將子目錄加入到建置中。source_dir 指定來源 CMakeLists.txt 和程式碼檔案所在的目錄。如果它是相對路徑,它會相對於目前目錄(典型的用法)進行評估,但也可能是一個絕對路徑。binary_dir 指定放置輸出檔案的目錄。如果它是相對路徑,它會相對於目前的輸出目錄進行評估,但也可能是一個絕對路徑。如果沒有指定 binary_dir,則會使用 source_dir 的值(在展開任何相對路徑之前)(典型的用法)。指定的來源目錄中的 CMakeLists.txt 檔案將由 CMake 立即處理,然後才會繼續處理目前輸入檔案中此命令之後的內容。

如果提供 EXCLUDE_FROM_ALL 參數,則會在加入的目錄上設定 EXCLUDE_FROM_ALL 屬性。這會將目錄從預設建置中排除。請參閱目錄屬性 EXCLUDE_FROM_ALL 以取得完整詳細資訊。

在版本 3.25 中新增: 如果提供 SYSTEM 參數,則子目錄的 SYSTEM 目錄屬性會設定為 true。此屬性用於初始化該子目錄中建立的每個非匯入目標的 SYSTEM 屬性。