CMake 教程

欢迎关注公众号【自动驾驶事务所】,分享更多以C/C++为计算机语言,以自动驾驶为方向的文章
欢迎关注公众号【自动驾驶事务所】,分享更多以C/C++为计算机语言,以自动驾驶为方向的文章

前面是中文,是我根据项目过程应用中用到的方面的知识。
后面附有英文版的,如果有不明白的地方,可以直接看英文版的。谢谢

CMake
下面是一个循序渐进的教程,介绍CMAKE帮助解决的常见构建系统用例。在掌握CMAKE时,已经介绍了许多这些主题作为单独的问题,但是看看它们如何在示例项目中一起工作是非常有帮助的。本教程可以在cmake源代码树的tests/tutorial目录中找到。每个步骤都有自己的子目录,其中包含该步骤教程的完整副本。
有关cmake概念和源树组织的概述,请参阅cmake构建系统(7)和cmake,(7)手册页的介绍部分。
基本起点(步骤1)

最基本的项目是从源代码文件构建的可执行文件。对于简单项目,只需要两行cmakelists.txt文件。这将是本教程的起点。cmakelists.txt文件如下:

cmake_minimum_required (VERSION 2.6)
project (Tutorial)
add_executable(Tutorial tutorial.cxx)

请注意,此示例在cmakelists.txt文件中使用小写命令。CMAKE支持upper、lower和mixed case命令。tutorial.cxx的源代码将计算一个数字的平方根,它的第一个版本非常简单,如下所示:
// A simple program that computes the square root of a number
#include <stdio.h>
#include <stdlib.h>
#include <math.h>
int main (int argc, char *argv[])
{
if (argc < 2)
{
fprintf(stdout,“Usage: %s number\n”,argv[0]);
return 1;
}
double inputValue = atof(argv[1]);
double outputValue = sqrt(inputValue);
fprintf(stdout,“The square root of %g is %g\n”,
inputValue, outputValue);
return 0;
}

添加版本号和配置的头文件

我们将添加的第一个特性是为可执行文件和项目提供一个版本号。虽然您可以在源代码中专门这样做,但在cmakelists.txt文件中这样做可以提供更多的灵活性。要添加版本号,我们修改cmakelists.txt文件,如下所示:
cmake_minimum_required (VERSION 2.6)
project (Tutorial)

The version number.

set (Tutorial_VERSION_MAJOR 1)
set (Tutorial_VERSION_MINOR 0)

configure a header file to pass some of the CMake settings

to the source code

configure_file (
PROJECTSOURCEDIR/TutorialConfig.h.in""{PROJECT_SOURCE_DIR}/TutorialConfig.h.in" "PROJECTSOURCEDIR/TutorialConfig.h.in""{PROJECT_BINARY_DIR}/TutorialConfig.h”
)

add the binary tree to the search path for include files

so that we will find TutorialConfig.h

include_directories(“${PROJECT_BINARY_DIR}”)

add the executable

add_executable(Tutorial tutorial.cxx)

https://cmake.org/cmake-tutorial/
上面是CMake 的官网,有需要的可以去看看。

CMake 是一个跨平台的开源构建系统,用于管理软件构建过程。它能够生成标准的构建文件(如 Makefile 或者 Visual Studio 项目文件),并且支持多种编译器和操作系统。CMake 通过 `CMakeLists.txt` 文件来描述项目的构建结构,这使得项目可以轻松地在不同的平台上进行构建。 ### 基本概念 - **CMakeLists.txt**: 每个 CMake 项目都需要至少一个 `CMakeLists.txt` 文件,该文件定义了项目的源代码、目标文件以及依赖关系。 - **构建目录**: 推荐创建一个独立的构建目录(例如 `build`),与源代码分离,以便清理或重新构建。 - **配置步骤**: 使用 `cmake` 命令从 `CMakeLists.txt` 生成构建文件。 - **构建步骤**: 使用平台相关的构建工具(如 `make`)来编译项目。 ### 安装 CMake 确保你的系统上已经安装了 CMake。可以通过包管理器安装,或者从官方网站下载最新版本。对于 Linux 用户,通常可以使用如下命令安装: ```bash sudo apt-get install cmake ``` 对于 macOS 用户,可以使用 Homebrew: ```bash brew install cmake ``` Windows 用户可以从 CMake 官网下载安装程序。 ### 创建一个简单的 CMake 项目 假设你有一个简单的 C++ 项目,结构如下: ``` my_project/ ├── CMakeLists.txt └── src/ └── main.cpp ``` #### 编写 CMakeLists.txt 在项目根目录下创建 `CMakeLists.txt` 文件,并添加以下内容: ```cmake # 指定所需的最低版本 cmake_minimum_required(VERSION 3.10) # 定义项目名称 project(MyProject) # 添加可执行文件 add_executable(MyExecutable src/main.cpp) ``` #### 构建项目 进入项目根目录,创建并进入构建目录: ```bash mkdir build && cd build ``` 运行 CMake 配置和生成构建文件: ```bash cmake .. ``` 然后使用构建工具编译项目: ```bash make ``` 编译完成后,可以在 `build` 目录中找到生成的可执行文件。 ### 高级技巧 - **多目录项目**: 对于更复杂的项目,可能需要将源代码组织到多个子目录中。每个子目录都可以有其自己的 `CMakeLists.txt` 文件,使用 `add_subdirectory()` 来包含这些子目录。 - **自定义编译选项**: 可以通过 `option()` 命令在 CMake 中添加自定义的编译选项。 - **查找库**: CMake 提供了 `find_package()` 命令来查找外部库。 - **预处理宏**: 在 CMake 中可以设置预处理宏,用于条件编译。 - **安装规则**: 使用 `install()` 命令来定义安装规则,便于部署应用程序。 ### 示例:多目录项目 如果项目结构如下: ``` my_project/ ├── CMakeLists.txt ├── src/ │ ├── CMakeLists.txt │ └── main.cpp └── lib/ ├── CMakeLists.txt └── mylib.cpp ``` 主 `CMakeLists.txt` 应该包含: ```cmake cmake_minimum_required(VERSION 3.10) project(MyProject) # 添加子目录 add_subdirectory(src) add_subdirectory(lib) ``` 在 `src/CMakeLists.txt` 中: ```cmake # 添加可执行文件,并链接库 add_executable(MyExecutable main.cpp) target_link_libraries(MyExecutable PRIVATE MyLibrary) ``` 而在 `lib/CMakeLists.txt` 中: ```cmake # 创建库 add_library(MyLibrary mylib.cpp) ``` 这样,当构建时,CMake 将会正确地处理所有依赖关系。 ### 学习资源 为了进一步学习 CMake,你可以参考官方文档,或者在线教程,比如《从零开始详细介绍CMake》这样的入门教程,它涵盖了从基础概念到高级技巧的全方位指导[^1]。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值