CMake 是一个跨平台的开源构建工具,用于自动化构建和管理 C/C++ 项目。它提供了一种简化的方式来定义和管理项目的构建过程,使得项目的构建更加灵活和可维护。本文将介绍 CMake 的基本概念和用法,帮助您快速上手使用 CMake 构建您的项目。
1. CMake 简介
CMake 是一个基于配置文件的构建系统生成工具。它使用一个名为 CMakeLists.txt
的配置文件来描述项目的构建过程。CMake 可以生成各种不同的构建系统文件(如 Makefile、Visual Studio 解决方案等),以便在不同的平台和编译环境下进行项目构建。
2. 安装 CMake
首先,您需要在您的系统上安装 CMake。您可以从 CMake
官方网站(https://cmake.org)下载适合您操作系统的安装包,并按照安装指南进行安装。
3. 创建 CMakeLists.txt 文件
在您的项目根目录下创建一个名为 CMakeLists.txt
的文件。这个文件将描述项目的构建过程。您可以使用文本编辑器打开该文件并开始编辑。
4. 基本语法
CMake 的配置文件使用一种简单的语法。以下是一些常用的指令和语句:
- cmake_minimum_required(VERSION <version>)
:指定所需的最低 CMake 版本。
- project(<project_name>)
:指定项目的名称。
- add_executable(<executable_name> <source_files>)
:定义可执行文件并指定源代码文件。
- add_library(<library_name> <source_files>)
:定义库并指定源代码文件。
- target_link_libraries(<target> <libraries>)
:指定目标文件与所需的库的链接关系。
5. 构建项目
在项目根目录下创建一个名为 build
的目录,并进入该目录。然后执行以下命令来生成构建系统文件:
cmake ..
接下来,根据您的构建系统执行以下命令进行项目构建:
- 对于 Makefile:执行 make
命令即可。
6. 示例
首先,创建一个名为 CMakeLists.txt
的文件,并将以下内容复制到文件中:
cmake
cmake_minimum_required(VERSION 3.12) # 指定所需的最低 CMake 版本
project(MyApp) # 指定项目的名称
# 添加可执行文件
add_executable(MyApp main.cpp) # 指定可执行文件的名称和源代码文件
# 可以在这里添加其他的配置和选项,例如链接库、定义宏等
接下来,在项目的根目录下创建一个名为 main.cpp
的源代码文件,并将以下内容复制到文件中:
#include <iostream>
int main() {
std::cout << "Hello, CMake!" << std::endl;
return 0;
}
现在,打开终端,并进入项目的根目录。创建一个名为 build
的目录,并进入该目录:
mkdir build
&&cd build
cmake .. && make -j
即可完成构建,生成的应用:
MyApp