步骤 6：添加支持测试仪表板

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

## Exercise 1 - Send Results to a Testing Dashboard

### Goal

用CDash显示Ctest的测试结果.

### Helpful Resources

+   `ctest(1)`
+   `include()`
+   `CTest`

### Files to Edit

+   `CMakeLists.txt`

### Getting Started

在顶层的 `CMakeLists.txt` 中完成 `TODO 1`，包含 `CTest` 模块。这将启用使用 CTest 进行测试以及向 CDash 提交仪表板，因此我们可以安全地删除对 `enable_testing()` 的调用。

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

+ 项目名称
+ 项目“每夜”开始时间
  + 此项目的 24 小时“一天”的开始时间。
+ CDash 实例的 URL，用于提交生成的文档的位置

在本教程中，使用了一个公共仪表板服务器，并且在本步骤的根目录中提供了相应的 `CTestConfig.cmake` 文件。在实践中，此文件将从打算托管测试结果的 CDash 实例的 `设置` 页面下载。从 CDash 下载后，应该不要在本地修改该文件。

CTestConfig.cmake

```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)
```

### Build and Run

请注意，作为 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](https://my.cdash.org/index.php?project=CMakeTutorial)。

### Solution

在此步骤中唯一需要更改的 CMake 代码是在我们的顶层 `CMakeLists.txt` 中包含 `CTest` 模块以启用向 CDash 提交仪表板。

TODO 1: CMakeLists.txt

```cmake
include(CTest)
```