CMake官方教程中文翻译 Step 6: Adding Support for a Testing Dashboard

鉴于自己破烂的英语，所以把cmake的官方文档用 谷歌翻译 翻译下来方便查看。
英语好的同学建议直接去看cmake官方文档（英文）学习：地址 点这里
或复制：https://cmake.org/cmake/help/latest/guide/tutorial/index.html

因为官方文档有点多，所以只截取CMake Tutorial的 step1——step12 进行翻译，这是第6步的翻译，以下是每一步的翻译链接：
Documentation » CMake Tutorial » Step 1: A Basic Starting Point
Documentation » CMake Tutorial » Step 2: Adding a Library
Documentation » CMake Tutorial » Step 3: Adding Usage Requirements for a Library
Documentation » CMake Tutorial » Step 4: Adding Generator Expressions
Documentation » CMake Tutorial » Step 5: Installing and Testing
[Documentation » CMake Tutorial » Step 6: Adding Support for a Testing Dashboard]
Documentation » CMake Tutorial » Step 7: Adding System Introspection
Documentation » CMake Tutorial » Step 8: Adding a Custom Command and Generated File
Documentation » CMake Tutorial » Step 9: Packaging an Installer
Documentation » CMake Tutorial » Step 10: Selecting Static or Shared Libraries
Documentation » CMake Tutorial » Step 11: Adding Export Configuration
Documentation » CMake Tutorial » Step 12: Packaging Debug and Release

谷歌翻译可能有错，此文档的目的仅是加快观看英文官方文档的速度，所以请结合英文官方文档观看

Step 6: Adding Support for a Testing Dashboard

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

Exercise 1 - Send Results to a Testing Dashboard（练习 1 - 将结果发送到测试仪表板）

Goal

使用 CDash 显示我们的 CTest 结果。

Helpful Resources

ctest(1)
include()
CTest

Files to Edit

CMakeLists.txt

Getting Started

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

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

项目名称

“每晚”项目开始时间

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

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

对于本教程，使用公共仪表板服务器，并在此步骤的根目录中为您提供相应的 CTestConfig.cmake 文件。 实际上，可以从用于托管测试结果的 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)

Build and Run

请注意，作为 CDash 提交的一部分，有关您的开发系统的一些信息（例如站点名称或完整路径名）可能会公开显示。

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

ctest [-VV] -D Experimental

请记住，对于多配置生成器（例如 Visual Studio），必须指定配置类型：

ctest [-VV] -C Debug -D Experimental

或者，从 IDE 构建实验目标。

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

Solution

此步骤中唯一需要更改的 CMake 代码是通过将 CTest 模块包含在我们的顶级 CMakeLists.txt 中来启用向 CDash 的仪表板提交：

TODO 1: CMakeLists.txt
include(CTest)