ctest_提交

作为 仪表板客户端 执行 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]
             )

将结果提交到仪表板服务器。默认情况下提交所有可用的部分。

选项是：

部分 <部分>...

指定要提交的零件子集。有效的部件名称是：

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.xml

文件 <文件>...

指定要提交的特定文件的明确列表。每个单独的文件在调用时必须存在。

SUBMIT_URL <url>

在 3.14 版本加入.

要将提交发送到的仪表板服务器的 http 或 https URL。如果未给出，则使用 CTEST_SUBMIT_URL 变量。

BUILD_ID <result-var>

在 3.15 版本加入.

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

HTTPHEADER <HTTP 标头>

在 3.9 版本加入.

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

ctest_submit(HTTPHEADER "Authorization: Bearer <auth-token>")

对于多个标题，此子选项可以重复多次。

RETRY_COUNT <计数>

指定重试超时提交的次数。

RETRY_DELAY <延迟>

指定在超时提交后尝试重新提交之前等待的时间（以秒为单位）。

RETURN_VALUE <result-var>

存储在 <result-var> 变量 0 表示成功，非零表示失败。

CAPTURE_CMAKE_ERROR <result-var>

在 3.13 版本加入.

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

安静

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