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 中新增。

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

QUIET

在版本 3.3 中新增。

告訴 CTest 抑制大多數非錯誤訊息，否則這些訊息會列印到主控台。CTest 仍會報告儲存庫的新修訂版本以及找到的任何衝突檔案。

更新始終遵循原始碼目錄中目前簽出的版本控制分支。請參閱 CTest 更新步驟 文件，以取得有關變更 ctest_update() 行為的變數資訊。