esp-idf cmake

### ESP-IDF CMake 使用指南

#### 配置与使用方法概述

对于ESP-IDF版本4.x及以上，Espressif提供了基于Eclipse CDT构建的IDE插件——idf-eclipse-plugin，支持CMake项目的创建、编译和调试功能[^1]。

#### 创建新项目

当利用CMake来管理ESP-IDF工程时，开发者可以轻松地通过命令行工具`idfgenerate.py`生成适用于不同集成开发环境（IDE）的工作区文件。然而，在大多数情况下，直接编辑根目录下的`CMakeLists.txt`更为常见也更加灵活。此文件定义了整个项目的结构以及各个源码模块之间的依赖关系。

# CMake最低版本需求声明
cmake_minimum_required(VERSION 3.5)

# 设置默认路径分隔符为Unix风格
set(CMAKE_EXPORT_COMPILE_COMMANDS ON)

include($ENV{IDF_PATH}/tools/cmake/project.cmake)
project(hello_world)

上述脚本片段展示了最基础的一个`CMakeLists.txt`模板，其中包含了指定所需的最小化CMake版本号，并导入官方提供的辅助宏指令集以便简化后续操作流程。

#### 添加组件

为了使自定义库成为可被其他部分引用的标准组成部分之一，则需按照特定格式编写对应的描述文档并放置于相应位置下：

- 组件应位于独立子文件夹内；
- 子文件夹名称即代表该组件的名字；
- 文件夹内部必须存在名为`CMakeLists.txt`的配置清单用于说明其属性特征；

下面是一个典型的例子，假设有一个叫做`mylib`的外部静态链接库希望加入到当前解决方案之中：

├── components/
│   └── mylib/
│       ├── include/
│       │   └── mylib.h
│       ├── src/
│       │   └── mylib.c
│       └── CMakeLists.txt
└── main/
    └── ...

对应`components/mylib/CMakeLists.txt`的内容如下所示：

idf_component_register(SRCS "src/mylib.c"
                       INCLUDE_DIRS "include")

这段代码的作用在于向系统注册一个新的可用部件，并指定了它所包含的具体实现单元(`SRCS`)及其头文件所在的位置(`INCLUDE_DIRS`)。

#### 构建过程

完成以上准备工作后，只需执行标准的CMake构建序列即可顺利完成整个应用程序镜像的制作：

mkdir build
cd build
cmake ..
make -j$(nproc)

这里先建立了一个临时输出空间(build)，接着调用了两次不同的程序：首先是`cmake ..`负责解析顶层控制语句并将之转换为目标平台特有的中间表示形式；其次是`make ...`真正启动多线程汇编/编译引擎以产出最终产物。