cmake使用教程（三）-安装、测试、系统自检

【cmake系列使用教程】

cmake使用教程（一）-起步

cmake使用教程（二）-添加库

cmake使用教程（三）-安装、测试、系统自检

cmake使用教程（四）-文件生成器

cmake使用教程（五）-cpack生成安装包

cmake使用教程（六）-蛋疼的语法

cmake使用教程（七）-流程和循环

cmake使用教程（八）-macro和function

这个系列的文章翻译自官方cmake教程：cmake tutorial。

示例程序地址：github.com/rangaofei/t…

不会仅仅停留在官方教程。本人做为一个安卓开发者，实在是没有linux c程序开发经验，望大佬们海涵。教程是在macos下完成，大部分linux我也测试过，有特殊说明的我会标注出来。本教程基于cmake-3.10.2，同时认为你已经安装好cmake。

本节将为咱们的项目添加安装规则和测试支持。此处仅讲解教程中添加的一些规则，后续有详细章节讲解定制本身的安装规则。只适用于macos和linux。

设置安装规则

安装规则至关简单。对于mathfunction库，咱们设添加了这个库，经过将如下两行添加到mathfunction的CMakeLists.txt中来安装头文件和静态库:

install (TARGETS MathFunctions DESTINATION bin)
install (FILES MathFunctions.h DESTINATION include)
复制代码

而后根目录下的CMakeLusts.txt文件中添加以下行,用来安装可执行文件和配置文件：

# add the install targets
install (TARGETS Tutorial DESTINATION bin)
install (FILES "${PROJECT_BINARY_DIR}/TutorialConfig.h"        
         DESTINATION include)
复制代码

注意上边install的第一个参数和第三个参数。

TARGETS包含六种形式：ARCHIVE, LIBRARY, RUNTIME, OBJECTS, FRAMEWORK, BUNDLE。注意Mathfunction安装的是LIBRARY，而根目录下的可执行文件是RUNTIME类型。

FILE 将给定的文件复制到指定目录。若是没有给定权限参数，则由该表单安装的文件默认为OWNER_WRITE、OWNER_READ、GROUP_READ和WORLD_READ。

TARGETS和FILE可指定为相对目录和绝对目录。

DESTINATION在这里是一个相对路径，取默认值。在unix系统中指向 /usr/local 在windows上c:/Program Files/${PROJECT_NAME}。

也能够经过设置CMAKE_INSTALL_PREFIX这个变量来设置安装的路径，那么安装位置不指向/usr/local，而指向你所指定的目录。

cmake .
make
makeinstall
复制代码

执行完毕后即安装了软件。

示例中指向的安装地址以下表所示:

文件/库	安装位置
MathFunctions	/usr/local/bin/
MathFunctions.h	/usr/local/include/
Tutorial	/usr/local/bin/
TutorialConfig.h	/usr/local/include

添加测试

添加测试也很是简单，在根目录下的CMakeLists.txt文件最后添加以下代码来测试输入参数后产生的结果是否正确。

include(CTest)

# does the application run
add_test (TutorialRuns Tutorial 25)
# does it sqrt of 25
add_test (TutorialComp25 Tutorial 25)
set_tests_properties (TutorialComp25 PROPERTIES PASS_REGULAR_EXPRESSION "25 is 5")
# does it handle negative numbers
add_test (TutorialNegative Tutorial -25)
set_tests_properties (TutorialNegative PROPERTIES PASS_REGULAR_EXPRESSION "-25 is 0")
# does it handle small numbers
add_test (TutorialSmall Tutorial 0.0001)
set_tests_properties (TutorialSmall PROPERTIES PASS_REGULAR_EXPRESSION "0.0001 is 0.01")
# does the usage message work?
add_test (TutorialUsage Tutorial)
set_tests_properties (TutorialUsage PROPERTIES PASS_REGULAR_EXPRESSION "Usage:.*number")
复制代码

构建项目完成后，能够运行ctest命令行工具来运行测试。第一个测试只是验证应用程序是否正常运行，没有发生崩溃，而且返回值是0。这是CTest测试的基本形式。接下来的几个测试都使用PASS_REGULAR_EXPRESSION测试属性来验证测试的输出是否包含特定的字符串。

若是您想要添加许多测试来测试不一样的输入值，您能够考虑建立以下的宏(至关于函数):

#define a macro to simplify adding tests, then use it
macro (do_test arg result)
  add_test (TutorialComp${arg} Tutorial ${arg})
  set_tests_properties (TutorialComp${arg}
    PROPERTIES PASS_REGULAR_EXPRESSION ${result})
endmacro (do_test)
 
# do a bunch of result based tests
do_test (25 "25 is 5")
do_test (-25 "-25 is 0")
复制代码

构建项目后执行ctest可获得以下结果：

 ~/Desktop/Tutorial/Step3/build/ ctest
Test project /Users/saka/Desktop/Tutorial/Step3/build
    Start 1: TutorialRuns
1/5 Test #1: TutorialRuns ..................... Passed 0.00 sec
    Start 2: TutorialComp25
2/5 Test #2: TutorialComp25 ................... Passed 0.01 sec
    Start 3: TutorialNegative
3/5 Test #3: TutorialNegative ................. Passed 0.00 sec
    Start 4: TutorialSmall
4/5 Test #4: TutorialSmall .................... Passed 0.00 sec
    Start 5: TutorialUsage
5/5 Test #5: TutorialUsage .................... Passed 0.00 sec

100% tests passed, 0 tests failed out of 5

Total Test time (real) =   0.03 sec
复制代码

能够看到，测试所有经过。

添加系统自检

有时候咱们可能会为多种平台开发程序，而有的平台包含某个库，有的平台不包含这个库，那么咱们就能够经过系统自检来判断是使用平台系统提供的库仍是本身编写的库。

下边咱们将添加一些依赖于目标平台是否具备log和exp函数的代码。固然，几乎每一个平台都有这些功能，但本教程假设它们不太常见。若是平台有log库，那么咱们将使用它来计算平方根，而不适用mysqrt中的函数。

首先使用CheckFunctionExists.cmake宏来测试这些函数的是否存在。在顶级CMakeLists.txt文件中编写代码以下:

# does this system provide the log and exp functions?
include (CheckFunctionExists)
check_function_exists (log HAVE_LOG)
check_function_exists (exp HAVE_EXP)
复制代码

而后在TutorialConfig.h.in中添加使用上边定义的变量的代码：

// does the platform provide exp and log functions?
#cmakedefine HAVE_LOG
#cmakedefine HAVE_EXP
复制代码

有一点须要注意：log和exp的测试代码必定要在TutorialConfig.h的configure_file命令以前。configure.file命令会当即使用CMake中的当前设置配置文件。最后，在mysqrt函数中，咱们能够提供一个基于log和exp的替代实现，若是它们在系统上可用如下代码可用:

// if we have both log and exp then use them
#if defined (HAVE_LOG) && defined (HAVE_EXP)
  result = exp(log(x)*0.5);
#else // otherwise use an iterative approach
  ...
复制代码