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