CMake 快速上手

本文我们将创建一个简单的 CMake 工程示例 —— 使用 C++ 的 Hello World 程序。

在开始之前，先使用 mkdir 和 cd 命令创建并切换到该工作目录，例如：

mkdir projectzero
cd projectzero

接着，我们创建一个 C++ 源文件 main.cpp，它要做的就是打印一串“Hello World”。

您可以使用习惯的编辑器打开它，例如：

vi main.cpp

输入如下内容：

#include <iostream>

int main() {
    std::cout << "Hello World!" << std::endl;
    return 0 ;
}

接着，我们要创建一个 CMakeLists.txt 文件（要注意大小写），这个文件是 CMake 必需的！

vi CMakeLists.txt

CMake 工程的根目录（本案例是 ~/projectzero 目录）必须包含一个 CMakeLists.txt 文件，其中的每一行都有一个命令，用于描述构建信息。

我们这个项目的 CMakeLists.txt 文件非常简单，只包含以下三行：

cmake_minimum_required(VERSION 3.0)

project(hello VERSION 0.0.1)

add_executable(hello main.cpp)

第一行表示 cmake 的最低版本要求，第二行描述该工程的基本信息（比如这里描述名称和版本），第三行表示使用源文件 main.cpp 编译可执行目标 hello 文件。

一个好习惯是将编译目录与工程文件分开，通常会建一个 build 目录，将构建过程产生的所有文件存放于此。

mkdir build

现在，整个工程目录结构是这样的：

├── build
├── CMakeLists.txt
└── main.cpp

切换到 build 目录，然后执行 cmake .. 生成 Makefile：

$ cd build
$ cmake ..
-- The C compiler identification is GNU 9.3.0
-- The CXX compiler identification is GNU 9.3.0
-- Check for working C compiler: /usr/bin/cc
-- Check for working C compiler: /usr/bin/cc -- works
-- Detecting C compiler ABI info
-- Detecting C compiler ABI info - done
-- Detecting C compile features
-- Detecting C compile features - done
-- Check for working CXX compiler: /usr/bin/c++
-- Check for working CXX compiler: /usr/bin/c++ -- works
-- Detecting CXX compiler ABI info
-- Detecting CXX compiler ABI info - done
-- Detecting CXX compile features
-- Detecting CXX compile features - done
-- Configuring done
-- Generating done
-- Build files have been written to: /home/getiot/projectzero/build

这里的 .. 表示当前目录的上一级目录（也就是 ~/projectzero 目录），用于告诉 cmake 到哪里去找 CMakeLists.txt 文件。另外，输出信息中的 CXX 表示的就是 C++。

执行完成后，会在 projectzero/build 目录生成一些配置文件：

$ ls
CMakeCache.txt  CMakeFiles  cmake_install.cmake  Makefile

现在可以开始编译了，输入下面命令就会构建出可执行文件 hello：

cmake --build .

您也可以直接执行 make 命令：

$ make
Scanning dependencies of target hello
[ 50%] Building CXX object CMakeFiles/hello.dir/main.cpp.o
[100%] Linking CXX executable hello
[100%] Built target hello

编译完成，运行程序：

$ ./hello 
Hello World!

恭喜您完成了第一个 CMake 工程，虽然只是一个简单的工程示例，但这是学习 CMake 的一个很好的起点！想学习更多示例，可以点击 GitHub profile。

总结

In this article we learnt how to install CMake on Linux and created a simple Hello World program using CMake. CMake is a very useful tool for C/C++ development. You can find more information about CMake in its documentation.

总结​

总结