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 = nothing Update = ctest_update results, in Update.xml Configure = ctest_configure results, in Configure.xml Build = ctest_build results, in Build.xml Test = ctest_test results, in Test.xml Coverage = ctest_coverage results, in Coverage.xml MemCheck = ctest_memcheck results, in DynamicAnalysis.xml and DynamicAnalysis-Test.xml Notes = Files listed by CTEST_NOTES_FILES, in Notes.xml ExtraFiles = Files listed by CTEST_EXTRA_SUBMIT_FILES Upload = Files prepared for upload by ctest_upload(), in Upload.xml Submit = nothing Done = Build is complete, in Done.xmlFILES <file>...指定要提交的特定文件显式列表。在调用时，每个独立文件都必须存在。
SUBMIT_URL <url>3.14 版本中新增。
http或httpsURL，用于将提交发送至仪表板服务器。如果没有给出，将使用CTEST_SUBMIT_URL变量。BUILD_ID <result-var>3.15 版本中新增。
将 CDash 分配给此构建的 ID 存储在
<result-var>变量中。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>将
0（成功）或非零（失败）存储在<result-var>变量中。CAPTURE_CMAKE_ERROR <result-var>3.13 版本中新增。
如果运行该命令时有任何错误，则将 -1 存储在
<result-var>变量中，并阻止 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 选项。