【CMake】CMake入门（二）

前言

本文在: 【CMake】CMake入门（一）的基础上继续讲解一些CMake的基础知识。

正文

在【CMake】CMake入门（一）一文中，test项目中文件夹内容如下：

test$ tree
.
├── a.cpp
├── b.cpp
├── c.cpp
├── head.h
└── main.cpp

CMake编译test项目用到的核心文件CMakeLists.txt的内容如下：

add_executable(app main.cpp a.cpp b.cpp c.cpp)

这条命令用于编译main.cpp、a.cpp、b.cpp、c.cpp四个源文件文件生成app可执行文件。
接下来介绍一些其他CMake基本语法。

注释

CMake中#表示行注释，类似与C语言中的//
举例：

#这是一行CMake注释
add_executable(app main.cpp a.cpp b.cpp c.cpp)

也可以用#[[]]进行块注释，类似于C语言中的/**/
举例：

#这是一行CMake注释
#[[这是一块CMake注释，
这是一块CMake注释,
这是一块CMake注释]]
add_executable(app main.cpp a.cpp b.cpp c.cpp)

cmake_minimum_required

cmake_minimum_required用于指定使用CMake的最低版本。
举例：

#这是CMakeLists.txt文件的内容
cmake_minimum_required(VERSION 3.0)
add_executable(app main.cpp a.cpp b.cpp c.cpp)

通过这种方式设置了使用CMake的最低版本为3.0。

project

project可以用于定义工程名称，这个工程名与add_executable(可执行程序名 源文件名称)中的可执行文件名没有关系。
举例：

#这是CMakeLists.txt文件的内容
cmake_minimum_required(VERSION 3.0)
project(TEST)
add_executable(app main.cpp a.cpp b.cpp c.cpp)

set

set用于设置变量名，通过${}的方式可以把变量内容取出。
举例：

#这是CMakeLists.txt文件的内容
cmake_minimum_required(VERSION 3.0)
project(TEST)

set(SRC_LIST main.cpp a.cpp b.cpp c.cpp)
add_executable(app ${SRC_LIST})

EXECUTABLE_OUTPUT_PATH

该宏用于指定可执行文件的输出路径，可以用set对其进行设置。
举例：

#这是CMakeLists.txt文件的内容
cmake_minimum_required(VERSION 3.0)
project(TEST)

set(EXECUTABLE_OUTPUT_PATH ./bin)
set(SRC_LIST main.cpp a.cpp b.cpp c.cpp)
add_executable(app ${SRC_LIST})

在文件CMakeLists.txt为以上内容时，cmake之后可以看到build文件中多出了一个bin文件，如图：

执行make后可以看到bin文件中生成了一个app可执行文件。

message

用于在控制台打印消息。
举例：

#这是CMakeLists.txt文件的内容
cmake_minimum_required(VERSION 3.0)
project(TEST)

set(EXECUTABLE_OUTPUT_PATH ./bin)
set(SRC_LIST main.cpp a.cpp b.cpp c.cpp)

message(SRC_LIST)
message(${SRC_LIST})
add_executable(app ${SRC_LIST})

可以看到cmake后打印内容如下：

message(SRC_LIST)对应打印内容为SRC_LIST
message(${SRC_LIST})对应打印内容为main.cppa.cppb.cppc.cpp

aux_source_directory

用于查找某个路径下所有文件，命令格式为：

aux_source_directory(< dir > < variable >)

dir表示要搜索的目录
variable 表示在dir目录中搜索到的源文件列表存储到该变量中。
举例：
将源文件移到src文件夹中，如下：

test$ tree
.
├── build
├── CMakeLists.txt
└── src
    ├── a.cpp
    ├── b.cpp
    ├── c.cpp
    ├── head.h
    └── main.cpp

CMakeLists.txt内容如下：

#这是CMakeLists.txt文件的内容
cmake_minimum_required(VERSION 3.0)
project(TEST)

aux_source_directory(./src SRC_LIST)
message(${SRC_LIST})
add_executable(app ${SRC_LIST})

cmake之后message打印内容为：

./src/a.cpp./src/b.cpp./src/c.cpp./src/main.cpp

make之后即可生成app可执行文件。