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 <build-dir>

指定頂層建置目錄。如果未給定，則會使用 CTEST_BINARY_DIRECTORY 變數。

SOURCE <source-dir>

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

APPEND

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

OPTIONS <options>

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

RETURN_VALUE <result-var>

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

CAPTURE_CMAKE_ERROR <result-var>

在版本 3.7 中新增。

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

QUIET

在版本 3.3 中新增。

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