对于初学者来说，刚开始学习STM32时候都使用的是Keil，很多项目都是在Keil环境下编译和调试的，这一章将描述如何将Keil工程迁移到STM32CubeIDE中。

          对照Keil下的新建工程步骤，创建工程、引入工程文件、添加预处理指令、添加头文件包含路径等步骤，STM32CubeIDE中也大同小异。 为了便于说明，我用STM32CubeMX生成了一个Keil5环境下的STM32F103C8T6亮灯程序，然后将其迁移到STM32CubeIDE中。
* d9 G  A4 B, w" ^& e6 P5 _, [

! ~) m, |! @7 I2 q' e
4 ]7 g, @1 r9 y! d

STM32F103C8T6亮灯程序

' b" H9 D8 f0 t9 p$ a

! [( o/ v" t4 G$ r) Y        如图所示，该文件夹内容是STM32CubeMX自动生成的，我们在该路径下面创建一个STM32CubeIDE_Test文件夹，用来存放STM32CubeIDE相关工程文件。

$ f* G% R' |$ I

$ t  Y1 j4 z, n% J# Y: Q/ b* T6 {8 a

创建工程文件夹

3 p, U9 h0 u! E  x+ p7 C% o) e$ V
  f9 R% \4 V, F" A/ g& l0 e( ?) j        参照上一章，先使用STM32CubeIDE创建一个STM32F103C8T6的工程，STM32CubeIDE的Workspace中的这三个文件就是我们需要的，这三个文件记录了STM32F103C8T6芯片的一些相关信息，我们可以直接拿来用，很方便。将其拷贝到上面在STM32CubeMX中创建的文件夹内。
( R$ s% \! ~% b9 K1 S! x; k. B$ y

) v$ }5 h9 ]" z
: n  b3 F3 L" Y1 w4 b6 _

STM32CubeIDE默认生成的文件

8 A9 Q5 i: j6 y- A这里简单介绍下这三个文件：

0 k4 f6 L1 G) n, L- L7 V.cproject ： 该文件是CDT插件的工程描述，CDT是Eclipse 的 C/C++ 开发工具。

.project：    该文件是Eclipse的工程描述，毕竟STM32CubeIDE就是基于Eclipse的。

STM32F103C8TX_FLASH.ld  ：该文件定义了程序入口地址，定义Flash、RAM中代码和数据的存放位置，将来搞Bootloader的时候就可以在这文件里面修改代码存放的起始地址。

  Y% Y, ?; H2 d! Y. V; v1 g+ D, r

* i; J8 m* a* [$ ~

拷贝文件到文件夹

        然后删除STM32CubeIDE中刚刚创建的工程，因为STM32CubeIDE只能存在一个相同名称的工程。在工程名上右键然后Delete，软件会提示是否删除硬盘上的数据，这里我们先不删除。
- D# z/ h' \2 D% Y- f

5 R: [8 A$ Y5 b3 y' K
& ?% G  o7 s: ~: \' K

删除工程

        进入我们在STM32CubeMX下创建的文件夹，点击.project，稍微等待一下就可以看到STM32CubeIDE已经导入了该工程。
9 |* r0 z: Q& {, @
' u, R2 @4 k) f7 r

1 u  q2 W- n6 n* r/ |% o
! k' I! a9 {) Q0 G5 F! w

导入工程

        STM32CubeIDE默认会加载和工程文件同一路径下的所有文件，这时候工程里面全是空的，我们只能看见刚刚三个文件中的STM32F103C8TX_FLASH.Id文件，我们需要做一些操作。

2 y5 |: G3 n( v( J6 A

/ r3 U7 q6 X: I+ [1 }  L1 d" L

空工程

9 V! ^' r  a/ o3 j$ G1 i! M
         像Keil一样，我们先将工程文件引入进来，如图所示，先选中工程，然后打开工程属性。
4 P: i+ p2 e8 l4 m) I, g

打开工程属性

, |6 w$ T- P& ?, \6 r1 _' O

        依次按下图所示步骤，将Core文件夹和Drivers文件夹链接到工程中，这两个文件夹存放了STM32的相关代码，而MDK-ARM主要存放了Keil5的相关工程文件，我们不链接。需要注意的是，链接路径里不能再次包含工程文件，如果这里我们直接链接这个目录的上层文件夹目录的话，将不能链接。
# q$ A: H1 }9 I+ U! l! H! C: x3 o
2 X2 L* x! j  P' P2 K

/ g# ~4 g5 r% n  I

引入文件

' W% `2 p' o5 \3 \& D& y        链接信息确认退出后就能在右侧看到引入的工程文件吗，而且外链的文件夹下面有个小箭头区分。

: o  ]: ?' v2 a* _

: @) L6 K7 R" L% M9 _

添加文件到工程目录

        在Keil中，我们需要设置头文件包含路径，在STM32CubeIDE中也一样，注意这张图里已有的是上一个工程自带的，我们把全部删除后再添加。

. S1 b" W+ w3 G# l! ^/ }6 t

添加包含路径

1 X# U4 }/ E- E

        添加完成后如下图所示，主要为HAL库的头文件、ARM内核的头文件。

0 y7 O! z$ ^* a. c2 _- W, d; f

头文件路径

9 H. A; B- [: E5 k& x- T
& Q! ?2 B. y4 a; i7 A5 t$ m
+ f% c* ~' N, x# s7 A: o% n0 @        添加预处理符号，在Keil5中也有该设置，声明一些全局的宏定义，主要是给HAL库使用，这里创建工程的时候已经包含了所需要的USE_HAL_DRIVER和STM32F103xB两个关键预处理，如果还有别的预处理，在此处新增即可。
% a# X6 Y  k: I/ j* e5 a2 R. q
# q8 w) D4 q/ x6 l& x2 x

预处理符号

4 q" n; S, w& w! Z! ]

        此时可以尝试编译一下，毫不意外，会有很多报错，由于STM32CubeIDE的特性，会将文件夹下所有的文件引入进来，而有一些不是我们需要的，这些不需要的文件都进行了编译，当然会报很多错误，我们可以通过删除不需要的文件或者排除文件在工程外两种方式，去掉不需要的文件。

        第一种是删除，例如下图这些文件，都是STM32CubeMX多余生成的，此处无用，直接右键删除。此处删除将会直接删除硬盘上的文件，谨记。
& M2 y2 i- ]& C$ {# b) y* u
& N1 ?+ N9 R4 w- @- q' T$ _; E

! G9 p  i1 b& l! w

删除不需要的文件

; `+ O& M; n8 W* Q6 g" u+ q        而对于一些其他文件，例如下图中STM32CubeMX生成的不同编译器下的汇编启动文件，如果我们要实现Keil5和STM32CubeIDE都可以编译的话，则不能删除，我们可以将不需要的文件排除在工程外。如下图所示，对着文件夹或者文件右键。

* {+ X4 z( v' A4 w4 G$ n9 V: D3 m" ~

排除文件夹

/ G  X3 V5 e+ U/ w

        然后在弹出的窗口全选，也可以用该方法来切换不同配置下工程编译包含文件，此处的Debug和Release就是两个不同的配置。

6 |+ b5 A$ L, E& s/ `5 {+ o* `

排除文件夹选项

9 G( N- L$ S: B* U
        注意到这时候被排除的文件就会有特别的标志显示。

排除的文件夹

        为了便于说明，对比删除和排除后目录差异。，Core文件夹下删除了system_stm32f1xx.c,该文件在Drivers文件夹下也有一份，两者只能存在一份，否则编译器会报错，也可以保留Core文件夹下的，看个人习惯。
) D( S. E3 a6 E. A8 U% w/ W3 O
# x& w1 L( O' d

3 k+ J4 C0 ?3 n' O  g. Z, v/ @

Core文件夹对比

7 A; Q1 t, E  ^) V

        Drivers下第一级目录，没使用到的全部删除。
4 Z( X1 @# F1 w* R
+ }+ B- l( ~3 W8 b$ ~: k5 d1 B

) u  \& W$ M6 c$ a$ }6 y0 B5 z& Y

Drivers文件夹对比

# e/ t% N* M! d+ _" @* ~6 K

        CMSIS文件夹下，删除了Core文件夹下的Template，删除了其他系列芯片的启动文件和.h文件。而Keil使用的汇编文件存放路径arm，IAR使用的汇编文件存放路径iar，则将其排除。
0 j( a; ^6 |6 [+ O

" q, Q0 ?2 h+ ]7 N5 y3 l% h

CMSIS文件夹对比

        STM32F1xx_HAL_Driver文件夹，Inc文件不用动，因为都是.h文件，Src文件夹下除了使用下图所示使用到的HAL文件，其他全部排除。

: a4 Z4 X1 L! ~9 Z) J) N

, K% I0 g5 |& C
8 c: x" D" L4 \9 Q8 A

HAL Driver文件夹

        经过以上步骤，此时再尝试编译，编译通过，生成了Debug文件夹，参照上一章内容，此时下载就可以运行。

7 p/ B! i" y6 h2 ~( ]  a
) ^; x; V  `0 |" ], m; H! N

STM32CubeIDE编译通过

+ n, f4 n. u2 k" E0 h& p0 p
% F" H! R, z$ |$ S        此时切回到Keil尝试编译，编译器报错找不到Core文件夹下的system_stm32f1xx.c文件，因为前面已经把他删除了，重新将Drivers文件下的system_stm32f1xx.c文件引入，此时Keil也能编译通过。

Keil编译

        如果需要调整优化等级，则可以再下图所示位置调整。

. S. c1 l: B6 n

% B2 t) n% O7 e% D9 g* d. v

调整优化等级

/ s& G, a. l9 r8 L# a7 V4 U4 }
        除了以上内容以外，我们还需要将工程内所有路径设置成相对路径，这样才可以像Keil那样，随意将代码放到任何位置都能编译，按下图所示步骤，将路径从绝对路径转换为相对路径。
0 r) p) }2 y4 s$ k1 }: k

7 t7 }+ q, H& L- u/ A- s
: |8 L- l! E7 H! F+ d

Linked Resources设置为相对路径

/ \9 g. a# d3 n( x. h

        前文提到的Id文件，此时已经是相对路径，如果不是的话也需要修改为相对路径。

& ]& r2 a6 c0 x1 p- A1 }" j

Id文件路径

; a4 z* v, P: B. \7 u9 T

        查看工程文件夹内，除了最开始拷贝过来的这三个文件，其余都是编译过程中产生的文件，提交代码或者拷贝到别处时都可以删除。
2 ?6 B8 B- ^& V# n; A  I/ Y
        额外需要注意的是，STM32CubeIDE只能存在一个相同名称的工程，所有拷贝到别处时还需要删除已有工程，只删除工程但是不删除硬盘数据，然后在别的路径下打开就可以自动导入。

        针对一个相同名称的工程问题，工程取名时最好也有些讲究。
0 V+ n7 O' H8 l) o& s6 i
; p$ x/ T* o9 @2 ~

/ f( z3 W! u/ T: f. ^; s6 \1 T7 Y
3 t& B4 ^, C9 S9 e* D7 h6 [# z# q1 V

编译后文件夹内容

6 c! e4 K. _" Z

# K6 k0 \# f, o4 ~# u- \        这样，通过外链文件夹、排除文件和设置相对路径，就可以不改变原有工程目录的情况下，将已有工程迁移到STM32CubeIDE中。
# |2 Z0 T& [# N/ `0 h* V

% w, V4 x& Z4 w7 q- _! T2 @