ctest_update

作为 Dashboard Client 执行 CTest Update Step。

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_update() 行为的变量的信息，请参阅 CTest Update Step 文档。