CMake项目实战教程：安装规则与测试支持详解-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00329/article/details/148464467

CMake项目实战教程：安装规则与测试支持详解

CMake Mirror of CMake upstream repository 项目地址: https://gitcode.com/gh_mirrors/cm/CMake

前言

在软件开发过程中，构建系统不仅要能够编译项目，还需要支持安装和测试功能。CMake作为主流的跨平台构建工具，提供了完善的安装和测试机制。本文将深入讲解如何在CMake项目中实现安装规则配置和测试支持。

安装规则配置

基本概念

安装规则定义了项目构建完成后，如何将生成的可执行文件、库文件和头文件等安装到指定位置。CMake通过install()命令提供这一功能。

实战步骤

库文件安装配置

在MathFunctions/CMakeLists.txt中添加以下内容：

# 安装MathFunctions库和tutorial_compiler_flags库到lib目录
install(TARGETS MathFunctions tutorial_compiler_flags
        DESTINATION lib
)

# 安装头文件到include目录
install(FILES MathFunctions.h
        DESTINATION include
)

可执行文件安装配置

在主CMakeLists.txt中添加：

# 安装可执行文件到bin目录
install(TARGETS Tutorial
        DESTINATION bin
)

# 安装配置头文件到include目录
install(FILES "${PROJECT_BINARY_DIR}/TutorialConfig.h"
        DESTINATION include
)

安装执行方式

CMake提供了多种安装执行方式：

命令行安装（CMake 3.15+）

cmake --install . --prefix "/your/install/path"

多配置构建安装

cmake --install . --config Release

IDE构建安装 构建名为INSTALL的特殊目标

关键变量说明

CMAKE_INSTALL_PREFIX：指定安装根目录
DESTINATION：指定相对于安装前缀的目标路径

测试支持实现

CTest基础

CTest是CMake自带的测试工具，可以方便地管理项目测试用例。

测试配置步骤

启用测试支持

在主CMakeLists.txt中添加：

enable_testing()

添加基本测试用例

# 测试程序是否能正常运行
add_test(NAME Runs COMMAND Tutorial 25)

# 测试参数错误时的提示信息
add_test(NAME Usage COMMAND Tutorial)
set_tests_properties(Usage
  PROPERTIES PASS_REGULAR_EXPRESSION "Usage:.*number"
)

# 测试计算结果是否正确
add_test(NAME StandardUse COMMAND Tutorial 4)
set_tests_properties(StandardUse
  PROPERTIES PASS_REGULAR_EXPRESSION "4 is 2"
)

创建通用测试函数

对于需要多个类似测试的情况，可以创建测试函数：

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(Tutorial 4 "4 is 2")
do_test(Tutorial 9 "9 is 3")
do_test(Tutorial 5 "5 is 2.236")