GCC + Vscode 搭建 STM32 开发环境（二）

Cmake 管理工程灵活性很高，且 Cmake 官方文档并没有提供一个完整的模板教用户如何去较好的组织一个项目。 结合工程实践，我整理出了一套自己的使用方法。在我的项目里面，一共有三类 Cmake 文件：

这部分的文件后缀是 cmake，主要提供在使用 Cmake 管理工程时的共用部分。

这里面包含了两类文件：编译器说明文件和内核说明文件。

这个文件说明了在编译工程时使用的编译套件以及编译参数，具体可阅读代码的注释。

代码清单：arm-none-eabi.cmake

该文件描述了当前工程使用的处理器的内核信息，如内核版本、指令集类型、浮点运算单元类型等等。

代码清单：cortex_m4.cmake

代码清单：cortex_m0.cmake

其他内核的写法依葫芦画瓢就可以了。

值得注意的是 INCLUDE(${CMAKE_CURRENT_LIST_DIR}/arm-none-eabi.cmake) 这句话，这里是引用了第 1.1 小节提到的编译器描述文件。这有点类似 c 语言的 #include “xxxxx.h”。

而工程的 Cmake 文件又会引用处理器的描述文件。通过这种层层引用的操作，会把构建的必要参数传递给构建过程。

模块的 CmakeList.txt 用来组织功能模块的编译规则。这里以一个 LED 指示灯的驱动模块为例说明。 模块文件夹内容如图， ![[Cmake LED指示灯模块目录结构.png]] drv_led.c 和 drv_led.h 为具体的源代码，这里不展开。CmakeLists.txt 就是该模块的规则描述文件了，文件内容及说明如下。

代码清单：CmakeLists.txt

其中提到的 构建目标 是由工程的 CmakeLists.txt 指定的，在这里我们使用变量替代，在构建过程中会用实际的目标名称替换该变量。 在组织工程的时候，将需要的模块的子目录添加到工程的 CmakeLists.txt 中便可以完成对该模块的调用。这类似于 Keil 或 IAR 中工程右键添加文件或目录，只不过他们在后台帮你完成了构建脚本的修改。

工程的 CmakeList.txt 是整个项目的编译入口，主要： - 指定工程名称（构建目标名称）； - 构建规则声明； - 依赖管理； - 预定义宏； - ....

代码清单：CmakeList.txt

我通常习惯在 VScode 的工作空间放置两个目录， 具体看下图：

第 1 个目录是工程的目录，这样可以快速的查看工程的信息。

通常我的一个项目里面可能存在多个工程，而这些工程会引用一些公共过的库文件，所以这些文件会放置在项目的公共目录里面，如 components 目录。

那么这个时候，我会把整个项目的目录添加到工作空间，这样我就可以方便的查阅公共模块的代码或其他文件了。你会发现，在上述截图中的第二个目录会包含第一个目录的全部内容。

这只是我的习惯，你可以按照实际情况酢情处理。

到此为止，我们可以开始启动构建，并得到最终的二进制文件了。

展开 demo/.vscode 目录，创建 task,json 文件，这个文件会定义具体的生成与构建任务。

代码清单：tasks.json

该文件中具体的每个参数的含义这里不解释，具体的命令的含义在命令行编译的方式里面会有详细的说明。

创建好文件后，在 VScode 中使用快捷键 ctrl + shift + B，可以调出上述任务，点击对应的任务就可以执行了。

当然，你也可以通过菜单栏 Terminal / Run Task 打开相同的界面。

在 gcc 目录上右键，在弹出的菜单中点击 Open in Integrated Terminal，会打开一个终端。 在终端输入命令：

创建构建的过程文件以及最终输出文件的存放路径，你可以取其他名称。

当然了，你也可以直接在 gcc 目录启动构建，但是你的目录可能变得乱七八糟。 执行完该命令后，会进入该目录。

在终端输入如下命令，生成构建脚本，这里以 Ninja 为例。

命令内容解释：

目前，我们已经完成了构建脚本的生成，接下来可以启动构建了。

在终端输入如下命令，执行构建。

其中， -j8 是开启多线程编译，后面的数值表示使用的线程数。 编译输出的内容如下。

build 目录的内容如图。