ctest_submit¶
ctest_submit([PARTS <part>...] [FILES <file>...]
[SUBMIT_URL <url>]
[BUILD_ID <result-var>]
[HTTPHEADER <header>]
[RETRY_COUNT <count>]
[RETRY_DELAY <delay>]
[RETURN_VALUE <result-var>]
[CAPTURE_CMAKE_ERROR <result-var>]
[QUIET]
)
将结果提交到仪表板服务器。默认情况下，所有可用部分都会提交。
选项包括
PARTS <part>...指定要提交的部分子集。有效的部分名称是：
Start- 无。Update-ctest_update()结果，位于Update.xml中。Configure-ctest_configure()结果，位于Configure.xml中。Build-ctest_build()结果，位于Build.xml中。Test-ctest_test()结果，位于Test.xml中。Coverage-ctest_coverage()结果，位于Coverage.xml中。MemCheck-ctest_memcheck()结果，位于DynamicAnalysis.xml和DynamicAnalysis-Test.xml中。Notes-CTEST_NOTES_FILES列出的文件，位于Notes.xml中。ExtraFiles-CTEST_EXTRA_SUBMIT_FILES列出的文件。Upload-ctest_upload()准备上传的文件，位于Upload.xml中。Submit- 无。Done- 构建完成，位于Done.xml中。
FILES <file>...指定要提交的特定文件的显式列表。每个文件在调用时都必须存在。
SUBMIT_URL <url>3.14 版新增。
仪表板服务器的
http或httpsURL，用于发送提交。如果未给定，则使用CTEST_SUBMIT_URL变量。BUILD_ID <result-var>版本 3.15 新增。
在
<result-var>变量中存储CDash分配给此构建的ID。HTTPHEADER <HTTP-header>版本 3.9 中添加。
指定要在提交期间包含在向CDash的请求中的HTTP头。例如，CDash可以配置为仅接受来自经过身份验证的客户端的提交。在这种情况下，您应该在头中提供一个承载令牌。
ctest_submit(HTTPHEADER "Authorization: Bearer <auth-token>")
此子选项可以重复多次以添加多个头。
RETRY_COUNT <count>指定重试超时提交的次数。
RETRY_DELAY <delay>指定在超时提交后等待多长时间（以秒为单位）才能尝试重新提交。
RETURN_VALUE <result-var>在
<result-var>变量中存储0表示成功，非零表示失败。CAPTURE_CMAKE_ERROR <result-var>3.13 版本新增。
如果运行命令时有任何错误，则在
<result-var>变量中存储 -1，并防止 ctest 在发生错误时返回非零值。QUIET3.3 版本中新增。
抑制所有原本会打印到控制台的非错误消息。
提交到CDash上传API¶
版本 3.2 中新增。
ctest_submit(CDASH_UPLOAD <file> [CDASH_UPLOAD_TYPE <type>]
[SUBMIT_URL <url>]
[BUILD_ID <result-var>]
[HTTPHEADER <header>]
[RETRY_COUNT <count>]
[RETRY_DELAY <delay>]
[RETURN_VALUE <result-var>]
[QUIET])
此第二个签名用于通过CDash文件上传API将文件上传到CDash。API首先发送上传请求到CDash以及文件的内容哈希。如果CDash尚未拥有该文件，则会上传该文件。除了文件之外，还指定了一个CDash类型字符串，以告知CDash使用哪个处理程序来处理数据。
此签名与第一个签名以相同的方式解释选项。
在版本3.8中新增：增加了RETRY_COUNT、RETRY_DELAY、QUIET选项。
在版本3.9中新增：增加了HTTPHEADER选项。
在版本3.13中新增：增加了RETURN_VALUE选项。
在版本3.14中新增：增加了SUBMIT_URL选项。
在版本3.15中新增：增加了BUILD_ID选项。