CMake教程－Step4（调试和安装）

最新推荐文章于 2024-08-24 08:53:54 发布

YLFM－明觉

最新推荐文章于 2024-08-24 08:53:54 发布

阅读量651

点赞数

分类专栏： CMake 文章标签： cmake

原文链接：https://cmake.org/cmake/help/latest/guide/tutorial/index.html

版权

CMake 专栏收录该内容

6 篇文章 0 订阅

订阅专栏

https://cmake.org/cmake/help/latest/guide/tutorial/index.html

安装和测试（步骤4）

现在，我们可以开始向我们的项目添加安装规则和测试支持。

安装规则

安装规则非常简单：对于MathFunctions，我们要安装库和头文件，对于应用程序，我们要安装可执行文件和配置的头文件。

因此，在MathFunctions / CMakeLists.txt的末尾添加：

install(TARGETS MathFunctions DESTINATION lib)

install(FILES MathFunctions.h DESTINATION include)

并在顶级CMakeLists.txt的末尾添加：

install(TARGETS Tutorial DESTINATION bin)

install(FILES "${PROJECT_BINARY_DIR}/TutorialConfig.h"
  DESTINATION include
  )

这就是创建本教程的基本本地安装所需的全部。

运行cmake可执行文件或cmake-gui来配置项目，然后使用所选的构建工具对其进行构建。通过从命令行使用cmake命令的安装选项（在3.15中引入，较早版本的CMake必须使用make install）运行安装步骤，或从IDE生成INSTALL目标。这将安装适当的头文件，库和可执行文件。

CMake变量CMAKE_INSTALL_PREFIX用于确定文件的安装根目录。如果使用cmake --install，则可以通过--prefix参数指定自定义安装目录。对于多配置工具，请使用--config参数指定配置。

验证已安装的教程正在运行。

测试支持

接下来，测试我们的应用程序。在顶级CMakeLists.txt文件的末尾，我们可以启用测试，然后添加一些基本测试以验证应用程序是否正常运行。

enable_testing()

# does the application run
add_test(NAME Runs COMMAND Tutorial 25)

# does the usage message work?
add_test(NAME Usage COMMAND Tutorial)

set_tests_properties(Usage
  PROPERTIES PASS_REGULAR_EXPRESSION "Usage:.*number"
  )

# define a function to simplify adding tests
function(do_test target arg result)
  add_test(NAME Comp${arg} COMMAND ${target} ${arg})
  set_tests_properties(Comp${arg}
    PROPERTIES PASS_REGULAR_EXPRESSION ${result}
    )
endfunction(do_test)

# do a bunch of result based tests
do_test(Tutorial 4 "4 is 2")
do_test(Tutorial 9 "9 is 3")
do_test(Tutorial 5 "5 is 2.236")
do_test(Tutorial 7 "7 is 2.645")
do_test(Tutorial 25 "25 is 5")
do_test(Tutorial -25 "-25 is [-nan|nan|0]")
do_test(Tutorial 0.0001 "0.0001 is 0.01")

第一个测试只是简单地验证应用程序正在运行，没有段错误或其他崩溃，并且返回值为零。这是CTest测试的基本形式。

#make test

下一个测试利用PASS_REGULAR_EXPRESSION测试属性来验证测试的输出是否包含某些字符串。在这种情况下，请验证在提供了错误数量的参数时是否打印了用法消息。

最后，我们有一个名为do_test的函数，该函数运行应用程序并验证所计算的平方根对于给定输入是否正确。对于do_test的每次调用，都会根据传递的参数将另一个测试连同名称，输入和预期结果一起添加到项目中。

重建应用程序，然后cd到二进制目录并运行ctest可执行文件：ctest -N和ctest -VV。对于多配置生成器（例如Visual Studio），必须指定配置类型。例如，要在“调试”模式下运行测试，请从构建目录（而不是“调试”子目录！）中使用ctest -C调试-VV。或者，从IDE构建RUN_TESTS目标。

实验代码：https://download.csdn.net/download/yufm/12673688