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

! ]7 g% ^3 E( o  F4 Q# O          对照Keil下的新建工程步骤，创建工程、引入工程文件、添加预处理指令、添加头文件包含路径等步骤，STM32CubeIDE中也大同小异。 为了便于说明，我用STM32CubeMX生成了一个Keil5环境下的STM32F103C8T6亮灯程序，然后将其迁移到STM32CubeIDE中。
! i0 X3 d' n' Q5 A; }& V

% |0 [9 R/ R, I& p
) d2 B9 G9 h. o

STM32F103C8T6亮灯程序

        如图所示，该文件夹内容是STM32CubeMX自动生成的，我们在该路径下面创建一个STM32CubeIDE_Test文件夹，用来存放STM32CubeIDE相关工程文件。
+ e) V6 a1 n0 `+ K

5 f4 C1 j- d2 s. c( ~

创建工程文件夹

' v' o( I0 p5 O' r& I  w

- K7 j( @+ Z' k2 v8 r- G        参照上一章，先使用STM32CubeIDE创建一个STM32F103C8T6的工程，STM32CubeIDE的Workspace中的这三个文件就是我们需要的，这三个文件记录了STM32F103C8T6芯片的一些相关信息，我们可以直接拿来用，很方便。将其拷贝到上面在STM32CubeMX中创建的文件夹内。
- N" ]# g) c* }( M, M

STM32CubeIDE默认生成的文件

. {+ r$ a6 f8 P. x3 N! a
5 |9 U1 Z$ K2 e) r, O7 h这里简单介绍下这三个文件：
" X4 E; p: f2 X% C; u" \+ Q7 A+ U
.cproject ： 该文件是CDT插件的工程描述，CDT是Eclipse 的 C/C++ 开发工具。
  r% C+ V& C# r% {5 ^4 ]
.project：    该文件是Eclipse的工程描述，毕竟STM32CubeIDE就是基于Eclipse的。

+ v' _3 V9 \; H8 c/ r( r' jSTM32F103C8TX_FLASH.ld  ：该文件定义了程序入口地址，定义Flash、RAM中代码和数据的存放位置，将来搞Bootloader的时候就可以在这文件里面修改代码存放的起始地址。
9 g0 t9 K; f. Z: X
3 H2 H# g" W; o/ _! @

4 C. {+ ?& t3 F( ~

拷贝文件到文件夹

        然后删除STM32CubeIDE中刚刚创建的工程，因为STM32CubeIDE只能存在一个相同名称的工程。在工程名上右键然后Delete，软件会提示是否删除硬盘上的数据，这里我们先不删除。

, {6 a& ~1 f% i* V$ Q4 w6 K  I

删除工程

1 r2 Z+ C. U' r( ]; q! S" K  B$ U

        进入我们在STM32CubeMX下创建的文件夹，点击.project，稍微等待一下就可以看到STM32CubeIDE已经导入了该工程。
: M# R4 m5 S+ S- N/ {: c
. N' s: I( e9 x  R' r" s* f0 D

. {% w( }$ Z4 E0 x  ?

导入工程

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

, i% D7 Z, C% f/ B& ~

空工程

* T! ^" ^. H* e0 Z* ]
- u6 x0 w0 L9 N, C$ n         像Keil一样，我们先将工程文件引入进来，如图所示，先选中工程，然后打开工程属性。

3 S5 d% j  V# x: q( N
( o+ w7 t  [9 L; K* c3 g5 P

打开工程属性

; V* R7 M3 E& M( `4 W) k
3 ~7 V/ J& a: B1 @
& l6 o# O6 S5 T; x3 J" ~9 x- y& Z        依次按下图所示步骤，将Core文件夹和Drivers文件夹链接到工程中，这两个文件夹存放了STM32的相关代码，而MDK-ARM主要存放了Keil5的相关工程文件，我们不链接。需要注意的是，链接路径里不能再次包含工程文件，如果这里我们直接链接这个目录的上层文件夹目录的话，将不能链接。
+ I8 y5 `% ^+ Q+ \8 g4 n: n2 J

引入文件

: q( M4 Y% h8 z* [1 r; v        链接信息确认退出后就能在右侧看到引入的工程文件吗，而且外链的文件夹下面有个小箭头区分。
, [" a4 [9 ?7 M0 U8 ^# w) B

* G9 Y; J% J" B

添加文件到工程目录

5 }9 S1 ?; V. k! y) B. p, i        在Keil中，我们需要设置头文件包含路径，在STM32CubeIDE中也一样，注意这张图里已有的是上一个工程自带的，我们把全部删除后再添加。
2 E$ z9 n3 c% p# N2 c+ C- N
/ h; P$ `( n6 u3 f* O

添加包含路径

- Q6 `5 t0 g$ V* T: y( r
        添加完成后如下图所示，主要为HAL库的头文件、ARM内核的头文件。
  c6 I3 c! f5 [3 M
6 p& m4 P2 [9 q% B# `2 P

- ~9 S4 v, |- |$ r6 e& X
4 q2 }' @" A3 J* ?( r: Q

头文件路径

) E7 T8 ~7 H4 [; c% l' q; A8 Z" t

. O) e2 e' ^0 u; o  n  C2 k        添加预处理符号，在Keil5中也有该设置，声明一些全局的宏定义，主要是给HAL库使用，这里创建工程的时候已经包含了所需要的USE_HAL_DRIVER和STM32F103xB两个关键预处理，如果还有别的预处理，在此处新增即可。
; s; D2 H+ ]2 J  t' ]5 y1 P9 g
5 p) B0 K' w- c( S6 u

$ J( M( k2 P) |4 X; y. ]

预处理符号

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

/ d1 B5 \# H  [% L/ m) M/ v        第一种是删除，例如下图这些文件，都是STM32CubeMX多余生成的，此处无用，直接右键删除。此处删除将会直接删除硬盘上的文件，谨记。

6 `  x* b# N/ C+ t

$ G7 q& l, J/ D: [

删除不需要的文件

+ j4 |; y- B# h
) g; }% S! D8 I! ^
% |5 V" k. |7 |% Y4 S        而对于一些其他文件，例如下图中STM32CubeMX生成的不同编译器下的汇编启动文件，如果我们要实现Keil5和STM32CubeIDE都可以编译的话，则不能删除，我们可以将不需要的文件排除在工程外。如下图所示，对着文件夹或者文件右键。
" F* V$ V8 C# Y/ H

# ]; x: x, ]  p

排除文件夹

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

8 Q. J/ ]: T+ n

排除文件夹选项

; |7 D1 F& ?' u3 b- W4 c        注意到这时候被排除的文件就会有特别的标志显示。
2 i4 _, V1 O8 n  N( ~; |/ E/ w* p$ @
8 c4 C  }$ \4 l3 L# j2 D' X: c

0 h- C3 G' A; S& W
, x1 T0 c; G2 H( T% {+ S% {  Y' C

排除的文件夹

8 z$ T9 F9 k+ d( X' f
% ~# z& W) i0 j+ w3 s6 X' E, n
        为了便于说明，对比删除和排除后目录差异。，Core文件夹下删除了system_stm32f1xx.c,该文件在Drivers文件夹下也有一份，两者只能存在一份，否则编译器会报错，也可以保留Core文件夹下的，看个人习惯。

  f4 o/ j8 P( d: e" D

0 X& M# q: v& D9 f) ?+ Z

Core文件夹对比

        Drivers下第一级目录，没使用到的全部删除。

Drivers文件夹对比

3 n6 _, N& d( |8 C( L, T
        CMSIS文件夹下，删除了Core文件夹下的Template，删除了其他系列芯片的启动文件和.h文件。而Keil使用的汇编文件存放路径arm，IAR使用的汇编文件存放路径iar，则将其排除。
8 _  z- X; W; M/ u

4 G% c/ H$ @+ G9 c0 R5 D: g  m
: U8 H: d0 b5 l4 N7 S$ C

CMSIS文件夹对比

; w$ g- w; h$ t* m1 \
$ Z* z/ M( Y+ s
        STM32F1xx_HAL_Driver文件夹，Inc文件不用动，因为都是.h文件，Src文件夹下除了使用下图所示使用到的HAL文件，其他全部排除。

$ Z: K/ X. j- C- x" L' ~6 k7 M

HAL Driver文件夹

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

" r5 r" R* h( G1 a3 R8 j' U

STM32CubeIDE编译通过

" ?& F6 g) }  p

        此时切回到Keil尝试编译，编译器报错找不到Core文件夹下的system_stm32f1xx.c文件，因为前面已经把他删除了，重新将Drivers文件下的system_stm32f1xx.c文件引入，此时Keil也能编译通过。
% V! q2 J* y. F) T& Z6 _- D  x0 {

# ^$ e* z: {, s( j" j
- `; N( T$ b1 G/ R2 Y' {( Q  w1 ?

Keil编译

( G3 F/ A% [# C* E/ J  g! O- Y

        如果需要调整优化等级，则可以再下图所示位置调整。
& G4 k8 s5 K# R: ^/ R+ M- V
- C7 @8 L$ n' O. m

( b2 C  u' m1 Z

调整优化等级

' E% Z. `3 g4 r' k/ s

. h% {& }# i' D! L8 P8 P        除了以上内容以外，我们还需要将工程内所有路径设置成相对路径，这样才可以像Keil那样，随意将代码放到任何位置都能编译，按下图所示步骤，将路径从绝对路径转换为相对路径。

8 e: y" a4 n/ A" P4 T

Linked Resources设置为相对路径

$ U6 p9 Q* J" i6 m
/ T6 P( v( @" n8 b2 A% M        前文提到的Id文件，此时已经是相对路径，如果不是的话也需要修改为相对路径。
8 V7 ^) e  k) P3 _+ T3 w
2 {' [6 F0 l; n, j$ b

$ v7 d, {2 P" b7 L$ V( _& {

Id文件路径

        查看工程文件夹内，除了最开始拷贝过来的这三个文件，其余都是编译过程中产生的文件，提交代码或者拷贝到别处时都可以删除。
4 a) b* f% M9 d  r$ E
+ y0 u  ~. O. x7 B6 [' @: p3 n        额外需要注意的是，STM32CubeIDE只能存在一个相同名称的工程，所有拷贝到别处时还需要删除已有工程，只删除工程但是不删除硬盘数据，然后在别的路径下打开就可以自动导入。

        针对一个相同名称的工程问题，工程取名时最好也有些讲究。

* P- v( {. J/ U" f

编译后文件夹内容

7 h$ g5 q, X$ G% f

# W1 l$ w0 o& y  r        这样，通过外链文件夹、排除文件和设置相对路径，就可以不改变原有工程目录的情况下，将已有工程迁移到STM32CubeIDE中。
, d6 O) G" i" @: v0 H
& z0 |# X1 q4 E5 j$ m- p2 H$ W
9 O3 h, O, w# n/ d6 j6 ^