ctest_configure

執行 CTest 配置步驟，作為 儀表板客戶端。

ctest_configure([BUILD <build-dir>] [SOURCE <source-dir>] [APPEND]
                [OPTIONS <options>] [RETURN_VALUE <result-var>] [QUIET]
                [CAPTURE_CMAKE_ERROR <result-var>])

配置專案建置樹狀結構，並將結果記錄在 Configure.xml 中，以便使用 ctest_submit() 命令提交。

選項如下：

BUILD <建置目錄>

指定最上層建置目錄。如果未指定，則使用 CTEST_BINARY_DIRECTORY 變數。

SOURCE <原始碼目錄>

指定原始碼目錄。如果未指定，則使用 CTEST_SOURCE_DIRECTORY 變數。

APPEND

將 Configure.xml 標記為附加到自上次 ctest_start() 呼叫以來，先前提交至儀表板伺服器的結果。附加語義由正在使用的儀表板伺服器定義。這 *不會* 導致結果附加到先前呼叫此命令產生的 .xml 檔案。

OPTIONS <選項>

指定要傳遞給配置工具的命令列引數。

RETURN_VALUE <結果變數>

將原生配置工具的傳回值儲存在 <結果變數> 變數中。

CAPTURE_CMAKE_ERROR <結果變數>

在 3.7 版本中新增。

如果執行命令時發生任何錯誤，則將 -1 儲存在 <結果變數> 變數中，並防止 ctest 在發生錯誤時傳回非零值。

QUIET

在 3.3 版本中新增。

隱藏原本會列印到主控台的任何 CTest 特定非錯誤訊息。來自底層配置命令的輸出不受影響。