CMake使用教程(二)

时间 2019-11-24

标签 cmake 使用教程繁體版

原文原文链接

CMake 是一种跨平台的免费开源软件工具，用于使用与编译器无关的方法来管理软件的构建过程。在 Android Studio 上进行 NDK 开发默认就是使用 CMake 管理 C/C++ 代码，所以在学习 NDK 以前最好对 CMake 有必定的了解。html

本文主要以翻译 CMake 的官方教程文档为主，加上本身的一些理解，该教程涵盖了 CMake 的常见使用场景。因为能力有限，翻译部分采用机翻+人工校对，翻译有问题的地方，说声抱歉。c++

开发环境：git

macOS 10.14.6
CMake 3.15.1
CLion 2018.2.4

添加“库”的使用要求

示例程序地址github

使用要求能够更好地控制库或可执行文件的连接和包含行，同时还能够更好地控制 CMake 内部目标的传递属性。利用使用要求的主要命令是：shell

target_compile_definitions安全

给指定目标添加编译定义。bash
target_compile_optionsapp

给指定目标添加编译选项。ide
target_include_directories函数

给指定目标添加包含目录。
target_link_libraries

指定连接给定目标或其依赖项时要使用的库或标志。

控制 CMake 内部目标的传递属性有三种类型：

PRIVATE

属性只应用到本目标，不该用到连接本目标的目标。即生产者须要，消费者不须要。
PUBLIC

属性既应用到本目标也应用到连接目标的目标。即生产者和消费者都须要。
INTERFACE

属性不该用到本目标，应用到连接本目标的目标。即生产者不须要，消费者须要。

让咱们重构代码“提供选项”项目的代码，以使用现代 CMake 的使用要求方法。咱们首先声明，连接到 MathFunctions 的任何人都须要包含当前源目录，而 MathFunctions 自己不须要。所以，这里使用 INTERFACE。

将如下行添加到 MathFunctions/CMakeLists.txt 的末尾：

# state that anybody linking to us needs to include the current source dir
# to find MathFunctions.h, while we don't.
# 说明与咱们连接的任何人都须要包含当前源目录才能找到 MathFunctions.h，而咱们不须要。
target_include_directories(MathFunctions
        INTERFACE ${CMAKE_CURRENT_SOURCE_DIR}
        )
复制代码

如今，咱们已经指定了 MathFunction 的使用要求，咱们能够安全地从顶级 CMakeLists.txt 中删除对 EXTRA_INCLUDES变量的使用：

if(USE_MYMATH)
  add_subdirectory(MathFunctions)
  list(APPEND EXTRA_LIBS MathFunctions)
endif()

target_include_directories(Tutorial PUBLIC
        "${PROJECT_BINARY_DIR}"
        )
复制代码

在项目根目录运行命令编译项目和生成可执行文件：

cmake -B cmake-build-debug
cmake --build cmake-build-debug
复制代码

在项目根目录运行生成的可执行文件：

./cmake-build-debug/Tutorial 2
复制代码

终端输出：

Computing sqrt of 2 to be 1.5
Computing sqrt of 2 to be 1.41667
Computing sqrt of 2 to be 1.41422
Computing sqrt of 2 to be 1.41421
Computing sqrt of 2 to be 1.41421
Computing sqrt of 2 to be 1.41421
Computing sqrt of 2 to be 1.41421
Computing sqrt of 2 to be 1.41421
Computing sqrt of 2 to be 1.41421
Computing sqrt of 2 to be 1.41421
The square root of 2 is 1.41421
复制代码

安装

示例程序地址

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

所以，在 MathFunctions/CMakeLists.txt 的末尾添加：

# install rules
# 安装规则
install(TARGETS MathFunctions DESTINATION lib)
install(FILES MathFunctions.h DESTINATION include)
复制代码

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

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

这就是本地安装所需的所有。

在项目根目录运行命令编译项目和生成可执行文件：

cmake -B cmake-build-debug
cmake --build cmake-build-debug
复制代码

在项目根目录运行命令安装可执行文件：

cmake --install cmake-build-debug
复制代码

CMake 从3.15开始使用 cmake --install 安装文件。CMake 变量 CMAKE_INSTALL_PREFIX 用于肯定文件的安装根目录。若是使用 cmake --install，则能够经过 --prefix 参数指定自定义安装目录。对于多配置工具，请使用 --config 参数指定配置。

终端输出：

-- Install configuration: ""
-- Installing: /usr/local/lib/libMathFunctions.a
-- Installing: /usr/local/include/MathFunctions.h
-- Installing: /usr/local/bin/Tutorial
-- Installing: /usr/local/include/TutorialConfig.h
复制代码

在项目根目录执行命令：

Tutorial 2
复制代码

终端输出：

Computing sqrt of 2 to be 1.5
Computing sqrt of 2 to be 1.41667
Computing sqrt of 2 to be 1.41422
Computing sqrt of 2 to be 1.41421
Computing sqrt of 2 to be 1.41421
Computing sqrt of 2 to be 1.41421
Computing sqrt of 2 to be 1.41421
Computing sqrt of 2 to be 1.41421
Computing sqrt of 2 to be 1.41421
Computing sqrt of 2 to be 1.41421
The square root of 2 is 1.41421
复制代码

这个时候咱们调用的不是 cmake-build-debug 下的 Tutorial 文件，而是安装到 /usr/local/bin 目录下的 Tutorial 文件。咱们能够经过命令查看一下 Tutorial 的位置：

where Tutorial
复制代码

终端输出：

/usr/local/bin/Tutorial
复制代码

测试

示例程序地址

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

# enable testing
# 启用测试
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 测试的基本形式。

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

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

在项目根目录运行命令编译项目和生成可执行文件：

cmake -B cmake-build-debug
cmake --build cmake-build-debug
复制代码

在项目根目录运行命令测试应用程序：

cd cmake-build-debug
ctest
复制代码

终端输出：

Test project /Users/taylor/Project/Taylor/C/Study/cmake-tutorial/cmake-test/cmake-build-debug
    Start 1: Runs
1/9 Test #1: Runs ............................. Passed 0.00 sec
    Start 2: Usage
2/9 Test #2: Usage ............................ Passed 0.00 sec
    Start 3: Comp4
3/9 Test #3: Comp4 ............................ Passed 0.00 sec
    Start 4: Comp9
4/9 Test #4: Comp9 ............................ Passed 0.00 sec
    Start 5: Comp5
5/9 Test #5: Comp5 ............................ Passed 0.00 sec
    Start 6: Comp7
6/9 Test #6: Comp7 ............................ Passed 0.00 sec
    Start 7: Comp25
7/9 Test #7: Comp25 ........................... Passed 0.00 sec
    Start 8: Comp-25
8/9 Test #8: Comp-25 .......................... Passed 0.00 sec
    Start 9: Comp0.0001
9/9 Test #9: Comp0.0001 ....................... Passed 0.00 sec

100% tests passed, 0 tests failed out of 9

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

系统自检

示例程序地址

让咱们考虑向咱们的项目中添加一些代码，这些代码取决于目标平台可能不具有的功能。

对于此示例，咱们将添加一些代码，具体取决于目标平台是否具备 log 和 exp 函数。固然，几乎每一个平台都具备这些功能，但对于本教程而言，假定它们并不常见。

若是平台具备 log 和 exp ，那么咱们将使用它们来计算 mysqrt 函数中的平方根。咱们首先在顶级 CMakeList 中使用 CheckSymbolExists.cmake 宏测试这些功能的可用性。

# does this system provide the log and exp functions?
# 该系统是否提供log和exp函数？
include(CheckSymbolExists)
set(CMAKE_REQUIRED_LIBRARIES "m")
check_symbol_exists(log "math.h" HAVE_LOG)
check_symbol_exists(exp "math.h" HAVE_EXP)
复制代码

在 TutorialConfig.h 的 configure_file 命令以前完成对 log 和 exp 的测试很是重要，configure_file 命令使用 CMake 中的当前设置当即配置文件，因此 check_symbol_exists 命令应该放在 configure_file 以前。

如今，将这些定义添加到 TutorialConfig.h.in 中，以便咱们能够从 mysqrt.cxx中使用它们：

// does the platform provide exp and log functions?
// 平台是否提供log和exp函数？
#cmakedefine HAVE_LOG
#cmakedefine HAVE_EXP
复制代码

更新 MathFunctions/CMakeLists.txt 文件，以便 mysqrt.cxx知道此文件的位置：

target_include_directories(MathFunctions
          INTERFACE ${CMAKE_CURRENT_SOURCE_DIR}
          PRIVATE ${CMAKE_BINARY_DIR}
          )
复制代码

修改 mysqrt.cxx 以包含 cmath 和 TutorialConfig.h。接下来，在 mysqrt函数的同一文件中，咱们可使用如下代码（若是在系统上可用）提供基于 log 和 exp 的替代实现（在返回结果前不要忘记 #endif ！）：

咱们将在 TutorialConfig.h.in 中使用新定义，所以请确保在配置该文件以前进行设置。

#if defined(HAVE_LOG) && defined(HAVE_EXP)
    double result = exp(log(x) * 0.5);
    std::cout << "Computing sqrt of " << x << " to be " << result
              << " using log and exp" << std::endl;
#else
    double result = x;
    // do ten iterations
    for (int i = 0; i < 10; ++i) {
        if (result <= 0) {
            result = 0.1;
        }
        double delta = x - (result * result);
        result = result + 0.5 * delta / result;
        std::cout << "Computing sqrt of " << x << " to be " << result << std::endl;
    }
#endif
复制代码

在项目根目录运行命令编译项目和生成可执行文件：

cmake -B cmake-build-debug
cmake --build cmake-build-debug
复制代码

在项目根目录运行生成的可执行文件：

./cmake-build-debug/Tutorial 2
复制代码

终端输出：

Computing sqrt of 2 to be 1.41421 using log and exp
The square root of 2 is 1.41421
复制代码

CMake使用教程系列文章

CMake使用教程(一)
- 基础项目
- 添加版本号和配置头文件
- 指定C++标准
- 添加库
- 提供选项
CMake使用教程(二)
- 添加“库”的使用要求
- 安装
- 测试
- 系统自检
CMake使用教程(三)
- 指定编译定义
- 添加自定义命令和生成的文件
- 生成安装程序
- 添加对仪表板的支持
CMake使用教程(四)
- 混合静态和共享
- 添加生成器表达式
- 添加导出配置