Cmake中文教程（四）【2022.05.10】

第 4 步：安装和测试

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

安装规则

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

所以在 MathFunctions/CMakeLists.txt最后我们添加：

*MathFunctions/CMakeLists.txt* 
install(TARGETS MathFunctions DESTINATION lib)
install(FILES MathFunctions.h DESTINATION include)

在顶层 CMakeLists.txt的末尾，我们添加：

*CMakeLists.txt *
install(TARGETS Tutorial DESTINATION bin)
install(FILES "${PROJECT_BINARY_DIR}/TutorialConfig.h"
  DESTINATION include
  )

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

现在运行cmake可执行文件或 cmake-gui配置项目，然后使用您选择的构建工具构建它。

然后使用以下install选项 运行安装步骤cmake命令行中的命令（在 3.15 中引入，旧版本的 CMake 必须使用 make install）。对于多配置工具，不要忘记使用--config参数来指定配置。如果使用 IDE，只需构建 INSTALL目标。此步骤将安装适当的头文件、库和可执行文件。例如：

cmake --install .

CMake 变量CMAKEINSTALLPREFIX用于确定安装文件的根目录。如果使用cmake --install命令，可以通过 --prefix参数覆盖安装前缀。例如：

cmake --install . --prefix "/home/myuser/installdir"

导航到安装目录并验证安装的Tutorial是否能运行。

测试支持

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

*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 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 测试的基本形式。

下一个测试使用PASSREGULAREXPRESSIONtest 属性来验证测试的输出是否包含某些字符串。在这种情况下，验证在提供不正确数量的参数时是否打印了使用消息。

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

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