ctest_submit

执行 CTest Submit Step 作为 Dashboard Client。

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 可以配置为仅接受来自经过身份验证的客户端的提交。在这种情况下，您应该在标头中提供一个承载令牌。

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 选项。