Step 6: Adding Support for a Testing Dashboard¶

谷歌翻译
添加将测试结果提交到仪表板的支持很简单。我们已经在测试支持中为我们的项目定义了许多测试 。现在我们只需运行这些测试并将它们提交给 CDash。

练习 1 - 将结果发送到测试仪表盘
目标
使用 CDash 显示我们的 CTest 结果。

有用的资源
ctest(1)

include()

CTest

要编辑的文件
CMakeLists.txt

入门
对于本练习，在顶层完成，包括TODO 1CMakeLists.txtCTest模块。这将启用使用 CTest 进行测试以及将仪表板提交到 CDash，因此我们可以安全地删除对 enable_testing()。

我们还需要获取一个CTestConfig.cmake文件放在顶层目录中。运行时，ctest可执行文件将读取此文件以收集有关测试仪表板的信息。它包含：

项目名称

项目“Nightly”开始时间

该项目 24 小时“一天”的开始时间。

提交生成的文档将发送到的 CDash 实例的 URL

对于本教程，使用公共仪表板服务器，并 CTestConfig.cmake在此步骤的根目录中为您提供其相应的文件。实际上，该文件将从Settings用于托管测试结果的 CDash 实例上的项目页面下载。从 CDash 下载后，不应在本地修改该文件。

CTestConfig.cmake
set(CTEST_PROJECT_NAME “CMakeTutorial”)
set(CTEST_NIGHTLY_START_TIME “00:00:00 EST”)

set(CTEST_DROP_METHOD “http”)
set(CTEST_DROP_SITE “my.cdash.org”)
set(CTEST_DROP_LOCATION “/submit.php?project=CMakeTutorial”)
set(CTEST_DROP_SITE_CDASH TRUE)
构建并运行
请注意，作为 CDash 提交的一部分，有关您的开发系统的一些信息（例如站点名称或完整路径名）可能会公开显示。

要创建一个简单的测试仪表板，运行cmake 可执行文件或cmake-gui配置项目但不要构建它。相反，导航到构建目录并运行：

ctest [-VV] -D Experimental
请记住，对于多配置生成器（例如 Visual Studio），必须指定配置类型：

ctest [-VV] -C Debug -D Experimental
或者，从 IDE 构建Experimental目标。

这ctest可执行文件将构建项目、运行任何测试并将结果提交到 Kitware 的公共仪表板： https://my.cdash.org/index.php ?project=CMakeTutorial 。

解决方案
此步骤中唯一需要更改的 CMake 代码是启用仪表板提交到 CDash，方法是包括CTest我们的顶层模块 CMakeLists.txt：

TODO 1：单击显示/隐藏答案
TODO 1：CMakeLists.txt
include(CTest)