ctest_submit

执行 CTest 提交步骤，作为 仪表盘客户端。

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 或 https URL，用于发送提交。如果未给出，则使用 CTEST_SUBMIT_URL 变量。

BUILD_ID <result-var>

在 3.15 版本中添加。

将 CDash 分配给此构建的 ID 存储在 <result-var> 变量中。

HTTPHEADER <HTTP-header>

在 3.9 版本中添加。

指定在提交期间要包含在 CDash 请求中的 HTTP 标头。例如，CDash 可以配置为仅接受来自经过身份验证的客户端的提交。在这种情况下，您应该在标头中提供 bearer token

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 版本中添加。

如果运行命令时出现任何错误，则在 <result-var> 变量中存储 -1，并防止 ctest 在发生错误时返回非零值。

QUIET

在 3.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 选项。