cmake跨平台构建工具

Posted 魏天乐大帅哥

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了cmake跨平台构建工具相关的知识，希望对你有一定的参考价值。

目录

前言

  • CMake是一个跨平台的安装编译工具，可以用简单的语句来描述所有平台的安装(编译过程)。
  • CMake可以说已经成为大部分C++开源项目标配

因此，作为一名C C++发开人员，看到cmake不应该一脸茫然…

作为初学者，通俗的认为cmake就是一个linux下自动构建makefile等文件的实用工具！

广泛使用cmake的原因: 跨平台开发方便共享操作，使写Makefile更简便;

跨平台开发

假设有一个跨平台项目，其中C++代码可能会在不同的OS系统/IDE上共享;

  • Win下的VS
  • Linux下的gcc
  • MAC下的Xcode

当我们想添加一个bar.cpp 的源文件，我们就需要将其添加到各种OS使用的每个工具中：

为了保持运行环境的一致性，则必须多次进行类似的更新，还必须手动执行（在本例中，图中用红色标记的箭头）。

这种方法因为手动也容易出错，而且不灵活。

CMake通过在开发过程中添加额外的步骤来解决这个设计缺陷。

您可以在CMakeLists.txt文件中描述您的项目，并使用CMake自动生成构建项目的工具，使用跨平台CMake代码：

同样的操作-添加新的bar.cpp文件，现在只需一步即可完成：

跨平台的性质没有变，照样有很多不同的OS在共享代码，但是只需要一个cmake可以很好地维护起来;

CMake语法特性

基本语法格式：指令(参数 1 参数 2…)

  • 参数使用括号括起
  • 参数之间使用空格或分号分开(这里有点违背我们用逗号分隔参数的习惯)

指令是大小写无关的，参数和变量是大小写相关的

  • 语法指令部分有点像SQL,是大小写无关的

  • set(HELLO hello.cpp) # 设置变量HELLO的函数，后续会介绍
# 下面两条指令等价
add_executable(hello main.cpp hello.cpp)
ADD_EXECUTABLE(hello main.cpp $HELLO)

    变量使用$方式取值，但是在 if 条件控制语句中应直接使用变量名

CMake重要指令和常用变量

重要指令

cmake版本，项目工程，变量的设置:

  • cmake_minimum_required - 指定CMake的最小版本要求

    # 语法：cmake_minimum_required(VERSION versionNumber [FATAL_ERROR])

# CMake最小版本要求为2.8.3
2cmake_minimum_required(VERSION 2.8.3)

    linux下 cmake --version查看自己的cmake版本

  • project - 定义工程名称，并可指定工程支持的语言

# 语法：project(projectname [CXX] [C] [Java])   -- 方框中的为可选项

# 指定工程名为HELLOWORLD
project(HELLOWORLD)
  • set - 显式的定义变量
# 语法：set(VAR [VALUE] [CACHE TYPE DOCSTRING [FORCE]])

# 定义SRC变量，其值为main.cpp hello.cpp
set(SRC sayhello.cpp hello.cpp)  #注意参数之间 空格/;  分隔哦！

头文件的设置，库文件的路径，库文件的生成，库文件的链接:

  • include_directories - 向工程添加多个特定的 头 文 件 搜索路径 —>相当于指定g++编译器的-I(大写i)参数

(有了动态库和静态库，当然有对应他的头文件了)

# 语法：include_directories([AFTER|BEFORE] [SYSTEM] dir1 dir2 …)

# 将/usr/include/myincludefolder 和 ./include 添加到头文件搜索路径中
include_directories(/usr/include/myincludefolder ./include)
  • link_directories - 向工程添加多个特定的 库 文 件 搜索路径 —>相当于指定g++编译器的-L参数
# 语法：link_directories(dir1 dir2 …)  

# 将/usr/lib/mylibfolder 和 ./lib 添加到库文件搜索路径中
link_directories(/usr/lib/mylibfolder ./lib)
  • add_library - 生成共享库文件
# 语法：add_library(libname [SHARED|STATIC|MODULE] [EXCLUDE_FROM_ALL] source1 source2 … sourceN)

# 通过变量 SRC 生成 libhello.so 共 享 动态库hello，通过 (SHARED | STATIC)来选择
add_library(hello SHARED $SRC)

# 通过src/Swap.cpp 生成 libswap_library.a 共 享 静态库swap_library，通过 (SHARED | STATIC)来选择
add_library( swap_library STATIC src/Swap.cpp )
  • target_link_libraries - 为 target 添加需要链接的共享库 —>相同于指定g++编译器-l(小L)参数
# 语法：target_link_libraries(target library1library2…)

# 将hello动态库文件链接到可执行文件main
target_link_libraries(main hello)
  • 关于 -I -L -l 这三个选项的区别如下:

  • 编译参数选择，编译生成exe:

add_compile_options - 添加编译参数 -->相当于g++编译器 -std=c++11 -O2…

# 语法：add_compile_options(xxxx);

# 添加编译参数  -std=c++11 -O2
add_compile_options(-std=c++11 -O2)

add_executable - 生成可执行文件(最重要的一步，如果没可执行程序怎么运行？)

# 语法：**add_library(exename source1 source2 … sourceN)**

# 编译main.cpp生成可执行文件main
add_executable(main main.cpp)

其他工程源文件管理等杂项:

  • add_subdirectory - 向当前工程 添加 存放源文件的子目录，并可以指定中间二进制和目标二进制存放的位置 --多目录工程
 # 语法：add_subdirectory(source_dir [binary_dir] [EXCLUDE_FROM_ALL])
 
 # 添加src子目录，src中需有一个CMakeLists.txt
 add_subdirectory(src)

aux_source_directory - 发现一个目录下 所有的源代码文件 并将列表 存储在 一个 变量中，这个指令临时被用来自动构建源文件列表

# 语法：aux_source_directory(dir VARIABLE)


# 定义SRC变量，其值为当前目录下所有的源代码文件
aux_source_directory(. SRC)
#配合src， 编译SRC变量所代表的源代码文件，生成main可执行文件
add_executable(main $SRC)

常用变量

  • CMAKE_C_FLAGS gcc编译选项

  • CMAKE_CXX_FLAGS g++编译选项

# 利用set（）, 在CMAKE_CXX_FLAGS编译选项后追加-std=c++11
set( CMAKE_CXX_FLAGS "$CMAKE_CXX_FLAGS -std=c++11")
  • CMAKE_BUILD_TYPE 编译类型(Debug, Release)
#利用set（）， 设定编译类型为debug，调试时需要选择debug
set(CMAKE_BUILD_TYPE Debug) 

# 设定编译类型为release，发布时需要选择release
set(CMAKE_BUILD_TYPE Release)

下面几个自己玩:

  • CMAKE_C_COMPILER：指定C编译器
  • CMAKE_CXX_COMPILER：指定C++编译器
  • EXECUTABLE_OUTPUT_PATH：可执行文件输出的存放路径
  • LIBRARY_OUTPUT_PATH：库文件输出的存放路径

下面几个了解一下:

  • CMAKE_BINARY_DIR

  • PROJECT_BINARY_DIR

  • <projectname>__BINARY_DIR

    1. 这三个变量指代的内容是一致的。

    2. 如果是 in source build（内部构建），指的就是工程顶层目录。

    3. 如果是 out-of-source(外部构建 --推荐使用), 指的是工程编译发生的目录。

      PROJECT_BINARY_DIR 跟其他指令稍有区别，不过现在，你可以理解为他们是一致的。

  • CMAKE_SOURCE_DIR

  • PROJECT_SOURCE_DIR

  • <projectname>__SOURCE_DIR

    1. 这三个变量指代的内容是一致的,不论采用何种编译方式,都是工程顶层目录。

    2. 也就是在 in source build时,他跟 CMAKE_BINARY_DIR 等变量一致。

      PROJECT_SOURCE_DIR 跟其他指令稍有区别,现在,你可以理解为他们是一致的。

CMake编译工程

CMake目录结构：项目主目录（各种.c.h等源码的项目目录）,存在一个CMakeLists.txt文件

两种方式设置编译规则：

  1. 包含源文件的子文件夹包含CMakeLists.txt文件，主目录的CMakeLists.txt通过add_subdirectory添加子目录（这个子目录也包含一个CMakeLists.txt）即可；

-相当于 多目录 的工程,好多目录有好多.c .h

  1. 包含源文件的子文件夹未包含CMakeLists.txt文件，子目录编译规则就只体现在主目录的CMakeLists.txt中;

相当于只有一个主目录的CMakeLists.txt文件 – 单目录工程;

两种构建方式

  • 内部构建(in-source build)：不推荐使用

内部构建会在源文件的同级目录下产生一大堆中间文件，这些中间文件并不是我们最终所需要的，和工程源文件放在一起会显得杂乱无章。

## 内部构建
# 在当前项目主目录下，编译本目录的CMakeLists.txt，生成Makefile等文件

cmake .    # 在哪个目录下调用cmake，生成的中间文件就会存在这个目录下，和CMakeLists.txt位置无关

# 执行make命令，生成target可执行程序
make
  • 外部构建(out-of-source build)：推荐使用

将编译输出文件与源文件放到不同目录中,这样源文件中的代码结构不会变化太多，清晰明了;

## 外部构建
# 1. 在当前目录下，创建build文件夹
mkdir build 

# 2. 进入到build文件夹
cd build
 
# 3. 编译上级目录的CMakeLists.txt，生成Makefile和其他文件

cmake ..   # 在哪个目录下调用cmake，生成的中间文件就会存在这个目录下，和CMakeLists.txt位置无关

# 4. 执行make命令，生成target
make

编译实战

hello.hpp

#pragma once
#include<iostream>
using namespace std;
void Print()

    cout<<"Hello CMake!"<<endl;

test.cpp

#include"hello.hpp"

int main()

    Print();
    return 0;

可以看到，我们目的是main调用hello.hpp里的Print()函数，打印Hello CMake;

这里将hello.hpp文件放在 与test.cpp源文件同级目录的inculde目录下;

这样#include"hello.hpp"如果不指定include目录就会找不到; (正确写法:#include"./include/hello.hpp")

CMakeLists.txt

这里也能体现出来cmake简化了构建Makefile的过程(项目越大，越复杂 cmake的简化作用越明显)!

cmake_minimum_required(VERSION 2.8) #指定最小版本

project(HelloCMake) #指定工程名字

include_directories(./include) #添加头文件路径 -->等价于 g++ xxx -Iinclude

add_executable(hello test.cpp) #编译生成可执行程序 -->等价于g++ -o hello test.cpp

内部构建

当前目录结构:

我们在当前目录下直接运行:cmake . 生成 Makefile，并且make，运行程序:

运行后的源文件主目录结构:

可以看到，内部构建除了之前的工程源文件之外，多了一些cmake编译产生的中间文件,工程业务庞大可能会造成混淆，所以我们不建议这种方法;

外部构建

当前目录结构:

我们在当前目录 下 的build目录下 运行:cmake … 生成 Makefile，并且make，运行程序:

运行后的build目录结构:

运行后的源文件主目录结构:

可以看到，外部构建之前的源文件主目录没有新的cmake中间文件结合进来，那些文件去了我们可以设置的build目录中,与源文件区分开了，所以我们建议这种方法;

当然，可以通过其他的cmake操作或者bash指令，将生成的Makefile或者可执行程序进行output从build目录中移动到别的指定目录，而且别忘了还有.sh shell脚本;

小结

cmake的好处:

  1. 跨平台开发的时候，cmake相当于对编译过程进行了二次封装，提高了该工程的跨平台性，各种OS的上策被cmake统一管理，方便了类似添加源文件等一系列改动;

  2. 简化了生成Makefile等构建工程文件的复杂度！

(我们借助这种好的工具，便于管理构建项目，让我们更多专注于业务的开发，只能说大老牛逼，真香~)

CMake跨平台编译工具

1、 什么是CMake?

Cmake是一个编译、构建工具。使用CMakeLists.txt来描述构建过程，可以生成标准的构建文件，如Makefile。一般先编写CMakeLists.txt，然后通过cmake来生成Makefile，最后执行make进行编译。

1.1 cmake安装
​ 在Ubuntu上安装cmake非常简单，执行sudo apt-get install cmake即可。如果想安装最新的cmake版本，就需要自己进行源码编译安装。源码下载路径:https://cmake.org/download。源码编译安装非常简单，这里就不再详细描述了。

1.2 查看cmake版本
cmake安装完成后，执行cmake --version，即可查看cmake的版本号。我的是3.5.1

2 CMake的基本使用流程

编写CMakeLists.txt
执行cmake .;一般在工程根目录下mkdir build;cd build;然后执行cmake ..;这样的目的是为了保证源码不会污染
执行make进行编译

3 CMake简单示例

这里给出一个简单的使用cmake进行构建的工程示例，目录结构如下:

test01
​ ├── build
​ ├── CMakeLists.txt
​ └── main.c

main.c文件如下:

#include <stdio.h>

int main(int argc, char** argv)

    printf("hello cmake\\n");
    return 0;

CMakeLists.txt内容如下:

#设置cmake的最小版本
CMAKE_MINIMUM_REQUIRED(VERSION 2.6)
#设置项目名称
project(test01)
#设置源文件
aux_source_directory(. dir_srcs)
#设置可执行程序
add_executable(test01 $dir_srcs)

我这里mkdir 了build 目录，主要避免中间文件污染源文件。

cd build
//格式：cmake + CMakeLists.txt路径，生成MakeFile文件 
cmake ..
//编译
make

跟多详细资料可以参考以下文件：

CMake实例：
https://www.hahack.com/codes/cmake/
CMake教程：
https://cmake.org/cmake/help/latest/guide/tutorial/index.html
CMake命令：
https://cmake.org/cmake/help/cmake2.4docs.html

以上是关于cmake跨平台构建工具的主要内容，如果未能解决你的问题，请参考以下文章

cmake跨平台构建工具

跨平台构建工具，cmake是 yyds ？ bjd ！

cmake入门教程 跨平台项目构建工具cmake介绍

cmake入门教程 跨平台项目构建工具cmake介绍

初见 cmake

如何使用CMake构建c++项目