鉴于自己破烂的英语,所以把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)