ctest_update¶
以Dashboard 客户端身份执行 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 更新步骤 文档。