CMAKE_USER_MAKE_RULES_OVERRIDE

指定一個 CMake 檔案來覆寫平台資訊。

當啟用來自 project() 或 enable_language() 命令的每個語言支援時，CMake 會載入指定的檔案。它會在 CMake 內建的編譯器和平台資訊模組載入之後，但在資訊使用之前載入。該檔案可以設定平台資訊變數以覆寫 CMake 的預設值。請參閱 CMAKE_USER_MAKE_RULES_OVERRIDE_<LANG> 以取得此變數的特定語言版本。

此功能僅用於覆寫在 CMake 建置其第一個測試專案以檢查語言編譯器是否運作之前，必須設定的資訊變數。不應在可以使用一般的 include() 的情況下，載入檔案。只有在無法以任何其他方式實現行為時，才將其作為最後手段。例如，可以設定 CMAKE_C_FLAGS_INIT 變數，以變更用於初始化 CMAKE_C_FLAGS 變數的預設值，然後將其快取。覆寫檔案不應用於設定在啟用語言後可以設定的任何內容，例如影響二進位檔放置位置的 CMAKE_RUNTIME_OUTPUT_DIRECTORY 之類的變數。檔案中設定的資訊也將用於 try_compile() 和 try_run() 建置。