在阅读UM1718文档的时候，发现CubeMX有个比较好的功能，可以用“.extSettings"文件一次，后续不管使用哪个IDE（只要是CubeMX支持的），都不需要再手动配置文件结构或包含头文件路径了，并且可以保持对各个IDE（只包括CubeMX支持的）配置的一致性，减少工作量。也有客户询问怎么添加工程文件的问题，考虑到可能有些同学不太了解这个功能，所以本文对这个功能进行介绍。

".extSettings"文件是对CubeMX配置的补充，是在CubeMX配置的基础上进行的额外配置，不是替换CubeMX的配置，这点需要注意。

1 @9 m; \* C5 l2 o0 u

总体来说，".extSettings"文件中的配置包含三部分，分别是[ProjectFiles]，[Groups]和[Others]，下面分别对这三个部分的功能进行介绍。

2.1. [ProjectFiles]

[ProjectFiles]这个部分主要是用来包含一些目录，例如头文件存放的目录。

0 a2 d  _/ g0 s7 U6 E

语法：HeaderPath=<include directory 1 path>;<include directory 2 path>

! [' z/ k1 B* o8 x4 x

示例：HeaderPath=../BSP/STM32H735G-DK

说明：这里的路径是相对于“*.cproject”或 “*.project”文件（如果生成的是CubeIDE的工程代码的话）的相对路径。如果生成的是其他IDE的工程代码，则这个路径是相对于其他工程文件的相对路径，例如“*.eww”文件（IAR）或“*.uvprojx”文件（KEIL）

  @+ V9 v( P/ i" L2 c6 t

效果：在".extSettings"文件中添加示例中的内容，重新生成代码后，效果如图1，红框部分是通过".extSettings"文件包含的目录，可以看到已经被包含到工程中。

配置[ProjectFiles]后CubeIDE工程包含的目录

4 w8 A; w1 k4 G/ W

这个部分主要是用来在工程中创建文件组并且将文件添加到文件组中，用来组织工程的文件结构。

' |$ R. e0 t5 w# h8 D

语法：<Group name>=<file pathname1>;<file pathname2>

8 I7 |$ i! m0 ~1 e% t

示例：Drivers/BSP/STM32H735G-DK=.. /BSP/STM32H735G-DK /stm32h735g_discovery.c;

说明：<Group name>是工程中的文件组名（若不存在则会自动创建）；<file pathname>是文件路径。示例中语句的作用是，嵌套创建“Drivers/BSP/STM32H735G-DK”这个文件组（可以多级嵌套创建），并且将“stm32h735g_discovery.c”文件添加进这个文件组中。可以在一个文件组中添加多个文件，只要多个<file pathname>之间通过分号（“；”）隔开即可。

效果：在".extSettings"文件中添加示例中的内容，重新生成代码后，效果如图2

[Others]这个部分主要是用来使能一些HAL模板和添加一些预处理定义语句。

2.3.1. 添加HAL模板

语法：HALModule=<ModuleName1>;<ModuleName2>;

0 J* s' w7 ~  Q

示例：HALModule=SPI;ADC;

0 J. H5 J9 Q- c0 R2 o/ I1 Y

效果：在".extSettings"文件中添加示例中的内容，重新生成代码后，如果使用H7系列的芯片创建的工程，则会自动在“stm32h7xx_hal_conf.h”文件（如果是其他系列的芯片的话，名字会略有区别）中添加”HAL_SPI_MODULE_ENABLED"和“HAL_ADC_MODULE_ENABLED"这两个宏定义，作用是在这个文件中包含SPI与ADC的头文件。如图3所示：

1 k  E+ ~, f- S) V3 l4 |% K

( [+ H( p: y1 j6 w8 H0 t

2.3.2. 添加预处理定义语句

语法：Define=<define1_name>;<define2_name>

4 P8 b* ]: d6 s, X

示例：Define=TEST_STM32H735G_DEMO

效果：在".extSettings"文件中添加示例中的内容，重新生成代码后，可以看到".extSettings"文件中配置的预定义语句已经被添加到工程中了。

. g3 `4 X$ O- K# {