CMake入门教程【基础篇】HelloCMake

概述

CMake是一个强大的跨平台构建系统，广泛用于C和C++项目。它使用简单的配置文件来生成标准的构建文件，从而使得构建过程跨平台且易于管理。本教程将通过一个“Hello World”示例（命名为HelloCMake）来介绍CMake的基本用法。

核心实现

• ad_executable()

指定应从指定的源文件构建可执行文件

第一个参数是要构建的可执行文件的名称

第二个参数是要编译的源文件列表。

• cmake_minimum_required

CMake支持对低版本

• project

设置项目名

代码示例

• CMakeLists.txt

cmake_minimum_required(VERSION 3.10)
project(HelloCMake)

add_executable(HelloCMake main.cpp)

• main.cpp

#include <iostream>

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

• 构建和运行

在项目根目录下，创建一个构建目录并进入：

mkdir build && cd build

运行CMake来生成构建文件，并使用make来构建项目：

cmake ..
make

然后，运行生成的可执行文件：

./HelloCMake

使用技巧

1. 版本要求：始终在CMakeLists.txt文件中指定CMake的最低版本要求。
2. 项目组织：保持项目文件的组织结构清晰，特别是对于大型项目。
3. 文档化：在CMakeLists.txt中添加注释，解释复杂的配置或自定义命令。

注意事项

1. 路径问题：避免在项目路径中使用空格和特殊字符。
2. CMake版本：确保使用的CMake版本与CMakeLists.txt中指定的最低版本兼容。
3. 构建目录：建议在项目外部创建一个构建目录，以避免污染源代码目录。

总结

CMake是构建C和C++项目的强大工具，它简化了跨平台构建过程。通过本教程的HelloCMake示例，您可以开始探索CMake的基本概念和使用方法。