CXX_SCAN_FOR_MODULES

在 3.28 版本新增。

CXX_SCAN_FOR_MODULES 是一個布林值,指定 CMake 是否掃描目標中的 C++ 原始碼以查找模組依賴項。另請參閱 CXX_SCAN_FOR_MODULES,它用於每個原始碼的設定,如果設定了,將會覆蓋目標範圍的設定。

這個屬性會由 CMAKE_CXX_SCAN_FOR_MODULES 變數的值初始化,如果該變數在目標建立時已設定。

當這個屬性設定為 ON 或未設定時,CMake 會在建置時掃描目標的 CXX 原始碼,並在編譯行中加入必要的模組依賴資訊。當這個屬性設定為 OFF 時,CMake 將不會在建置時掃描目標的 CXX 原始碼。

請注意,只有當目標啟用 C++20 或更高版本時才會執行掃描。對於屬於 CXX_MODULES 類型的檔案集合中目標的原始碼,始終會執行模組掃描。