【CMake】CMake构建C++代码（一）

👉博__主👈：米码收割机

👉技__能👈：C++/Python语言

👉公众号👈：测试开发自动化

👉专__注👈：专注主流机器人、人工智能等相关领域的开发、测试技术

CMake构建C++代码

在Linux开发过程中，难免会用到CMake来构建你的代码。本文将说明如何构建自己的代码，将自己的代码变为共享库，共其他代码使用。

（关注“测试开发自动化” 弓中皓，获取更多学习内容）

CMake简述

如果有朋友在Linux端使用C/C++/Fortran/Java这几种语言开发，相信对CMake构建工具不会陌生，也是大多数程序员必须掌握的一项代码构建技能。

之所以Cmake会进入大多数程序员的视线，为大多数程序员使用，主要是因为CMake主要有如下特点：

1. 原生支持 C/C++/Fortran/Java 的相依性的自动分析功能，免除了程序员对代码依赖的调整，对整个开发工作帮助很大。
2. 支持 SWIG、Qt、FLTK 开发框架。
3. 支持跨平台编译，这是CMake名字的来源。
4. CMake需要用户用CMake规范的语法编写CMake脚本，该语法简单易用，入门极其顺手。
5. 能够转换特殊平台的 IDE 项目文档，如xcode。
6. 与Dart、CTest 和 CPack 集成，可以组成自动化的构建系统。

需要注意的是：使用CMake，程序员必需编写好CMake脚本CMAkeLists.txt，对于一些复杂的项目，可能需要编写CMake模块，但对于构建过程而言，则是极其简单的。

一、构建你的第一个CMake工程

首先，要是知道，一个标准工程，文件夹的结构应该是这样的：

1. doc文件夹：存放工程的文档
2. src文件夹：存放源文件
3. bin文件夹：存放构建后的目标文件

好了，下面我们就来搭建一个简单的工程使用CMake来构建！，我们构建的前提都是在Linux系统下进行示例的。因此，大家学习的时候最好在Linux系统下学习。

2.1 工程结构

我们在自己的Linux系统的home路径下（或你自己的系统）创建一个它文件夹，并在对应的文件夹下建立对应的文件。整个t3文件夹的结构如下所示：

t3
├── build
├── CMakeLists.txt
└── lib
       ├── CMakeLists.txt
       ├── hello.cpp
       └── hello.h

2.2 文件内容

上面创建了空的文件，下面我们就要对文件中的内容进行补充：

1. t3/CMakeLists.txt文件：

project(hellolib) # 工程名

add_subdirectory(lib) # 在工程目录下(build文件夹)生成一个lib文件夹，并将动态、静态文件存储在build/lib文件夹下

2. t3/lib/CMakeLists.txt文件：

set(LIBHELLO_SRC hello.cpp)

add_library(hello SHARED ${LIBHELLO_SRC}) # 生成一个hello.so的动态库文件

add_library(hello_static STATIC ${LIBHELLO_SRC}) # 生成一个hello_static.o的静态库文件

#为使生成的动态库和静态库名称一致，需要使用 set_target_properties

set_target_properties(hello_static PROPERTIES OUTPUT_NAME “hello”) # 将hello_static重命名为hello# 可得到libhello.so 和 libhello.a

set_target_properties(hello PROPERTIES VERSION 1.2 SOVERSION 1) # 设置生成的.so的版本为1.2

INSTALL(TARGETS hello hello_static # 将动态库libhello.so、libsello.a安装到/usr/lib中

LIBRARY DESTINATION lib

ARCHIVE DESTINATION lib

)

INSTALL(FILES hello.h DESTINATION include/hello) # 将头文件安装到/usr/include/hello中

3. hello.cpp文件：

#include <iostream>
void HelloFunc()
{
    std::cout << "hello world"<< std::endl;
}

4. hello.h文件：

#ifndef HELLO_H
#define HELLO_H
#include <iostream>
void HelloFunc();
#endif

三、开始构建

这里主要采用的是外部构建的方式。外部构建即在将构建的信息生成在build文件夹中，也是极力推荐这样构建，所以内部构建这里就不作过多的解释。

在终端中输入如下Linux指令：

cd build
cmake .. && make

四、构建后build文件夹结构

构建后，build文件夹结构如下所示：

build
├── CMakeCache.txt
├── CMakeFiles
├── cmake_install.cmake
├── Makefile
└── lib
       ├── CMakeFiles
       ├── cmake_install.cmake
       ├── Makefile
       ├── libhello.a        # set_target_properties(hello_static PROPERTIES OUTPUT_NAME "hello") 
       ├── libhello.so       # set_target_properties(hello_static PROPERTIES OUTPUT_NAME "hello") 
       ├── libhello.so.1     # set_target_properties(hello PROPERTIES VERSION 1.2 SOVERSION 1)
       └── libhello.so.1.2   # set_target_properties(hello PROPERTIES VERSION 1.2 SOVERSION 1)

五、安装共享库

如果你希望其他人可以直接仅通过.h文件即可调用的你的代码，那么你就需要安装共享库。作用是：将头文件和共享库安装到系统目录/usr/lib 和/usr/include/hello，可以直接通过include<hello.h>的方式使用（相当于Windows的环境变量）。在build文件夹下输入：

make install

六、总结

至此，我们就完成了我们的共享库的构建，后续会讲解如何使用共享库来运行我们的代码。

（关注“测试开发自动化” 弓中皓，获取更多学习内容）