ctest_update

執行 CTest 更新步驟，作為 儀表板用戶端。

ctest_update([SOURCE <source-dir>]
             [RETURN_VALUE <result-var>]
             [CAPTURE_CMAKE_ERROR <result-var>]
             [QUIET])

從版本控制更新來源樹，並將結果記錄在 Update.xml 中，以使用 ctest_submit() 指令提交。

選項如下：

SOURCE <source-dir>

指定來源目錄。若未指定，則使用 CTEST_SOURCE_DIRECTORY 變數。

RETURN_VALUE <result-var>

將更新的檔案數量儲存在 <result-var> 變數中，若發生錯誤則儲存 -1。

CAPTURE_CMAKE_ERROR <result-var>

在版本 3.13 中新增。

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

QUIET

在版本 3.3 中新增。

告知 CTest 抑制大部分原本會列印到主控台的非錯誤訊息。CTest 仍會回報儲存庫的新修訂版本，以及找到的任何衝突檔案。

更新始終遵循目前在來源目錄中簽出的版本控制分支。請參閱 CTest 更新步驟 文件，以了解會變更 ctest_update() 行為的變數。