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

          对照Keil下的新建工程步骤，创建工程、引入工程文件、添加预处理指令、添加头文件包含路径等步骤，STM32CubeIDE中也大同小异。 为了便于说明，我用STM32CubeMX生成了一个Keil5环境下的STM32F103C8T6亮灯程序，然后将其迁移到STM32CubeIDE中。
3 V2 I( b$ c5 ]) Y8 L: o

STM32F103C8T6亮灯程序

$ Y8 |. L. [* Q% d

8 M* `2 r  g6 M  ~2 Q3 a6 R        如图所示，该文件夹内容是STM32CubeMX自动生成的，我们在该路径下面创建一个STM32CubeIDE_Test文件夹，用来存放STM32CubeIDE相关工程文件。

: ^1 j% `1 V& W! Y+ _

创建工程文件夹

        参照上一章，先使用STM32CubeIDE创建一个STM32F103C8T6的工程，STM32CubeIDE的Workspace中的这三个文件就是我们需要的，这三个文件记录了STM32F103C8T6芯片的一些相关信息，我们可以直接拿来用，很方便。将其拷贝到上面在STM32CubeMX中创建的文件夹内。
  S' h% Q4 r, {1 n3 M0 G6 Q9 b! P

% C! ~9 |" g& F; @# j+ u

STM32CubeIDE默认生成的文件

7 d6 Z4 X2 t, ]7 m6 U1 J8 R

这里简单介绍下这三个文件：
. q5 f! r/ i- u! d2 |
.cproject ： 该文件是CDT插件的工程描述，CDT是Eclipse 的 C/C++ 开发工具。
* k5 w8 C, ?5 P- b
.project：    该文件是Eclipse的工程描述，毕竟STM32CubeIDE就是基于Eclipse的。
2 J" `" L. W8 i2 f7 Y0 T
/ }" B9 y! K8 h3 GSTM32F103C8TX_FLASH.ld  ：该文件定义了程序入口地址，定义Flash、RAM中代码和数据的存放位置，将来搞Bootloader的时候就可以在这文件里面修改代码存放的起始地址。

( k7 o) |0 E9 P7 C

2 g  S* G) V* }2 v6 L4 i- c* X

拷贝文件到文件夹

- N* }; [; W  p# B8 j9 j
        然后删除STM32CubeIDE中刚刚创建的工程，因为STM32CubeIDE只能存在一个相同名称的工程。在工程名上右键然后Delete，软件会提示是否删除硬盘上的数据，这里我们先不删除。

! C5 T4 j9 c4 ]3 J; U& r& B2 _

删除工程

4 e8 l. ], \4 P, A
3 I: {" {' `$ g/ E
        进入我们在STM32CubeMX下创建的文件夹，点击.project，稍微等待一下就可以看到STM32CubeIDE已经导入了该工程。

2 ?% ^2 p; \" ]4 s

7 Q3 p) j- t6 c- Y/ J

导入工程

! B3 T0 n. _1 T3 X1 P) p" n        STM32CubeIDE默认会加载和工程文件同一路径下的所有文件，这时候工程里面全是空的，我们只能看见刚刚三个文件中的STM32F103C8TX_FLASH.Id文件，我们需要做一些操作。
# v- W. H% I- Q* x5 ^/ x9 p
( d. W0 S# \+ C* b& M: o

# \+ g( Y; l6 m
2 j7 o# |% w( ~% w( l

空工程

& D# W0 O7 g9 u0 E3 {

! M$ [6 z- [; v- q  f9 R6 t         像Keil一样，我们先将工程文件引入进来，如图所示，先选中工程，然后打开工程属性。
4 q. g+ m, ^! r9 ]
7 n/ l# B, z5 ~

打开工程属性

9 v+ ~% p7 D# I3 `3 m5 j# q        依次按下图所示步骤，将Core文件夹和Drivers文件夹链接到工程中，这两个文件夹存放了STM32的相关代码，而MDK-ARM主要存放了Keil5的相关工程文件，我们不链接。需要注意的是，链接路径里不能再次包含工程文件，如果这里我们直接链接这个目录的上层文件夹目录的话，将不能链接。

' E4 B- f6 X: E9 B) G0 f! M

引入文件

        链接信息确认退出后就能在右侧看到引入的工程文件吗，而且外链的文件夹下面有个小箭头区分。

2 b2 A9 d, t+ D% ^+ v

添加文件到工程目录

2 ?- b2 Z% k$ R* ?- Y

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

3 A/ V; U3 J3 }' ^5 x

添加包含路径

; m3 U9 m' i! K- o* \% u
* j8 U6 Y1 [# _/ h. D1 w$ i        添加完成后如下图所示，主要为HAL库的头文件、ARM内核的头文件。

# K6 Y! [$ Z! T3 `* r

头文件路径

# C6 y* @* }+ V, m: A" u  M
: T, r+ n& _$ A  `0 w  O
4 U5 O0 n+ M  c" h' Y7 r        添加预处理符号，在Keil5中也有该设置，声明一些全局的宏定义，主要是给HAL库使用，这里创建工程的时候已经包含了所需要的USE_HAL_DRIVER和STM32F103xB两个关键预处理，如果还有别的预处理，在此处新增即可。

3 f9 D. k% h/ K; H

预处理符号

; ^; y$ h3 i% i! W* E3 c( s        此时可以尝试编译一下，毫不意外，会有很多报错，由于STM32CubeIDE的特性，会将文件夹下所有的文件引入进来，而有一些不是我们需要的，这些不需要的文件都进行了编译，当然会报很多错误，我们可以通过删除不需要的文件或者排除文件在工程外两种方式，去掉不需要的文件。
) S+ \" e3 Q( o; Z
3 N0 Z$ e# R# O2 j0 l        第一种是删除，例如下图这些文件，都是STM32CubeMX多余生成的，此处无用，直接右键删除。此处删除将会直接删除硬盘上的文件，谨记。

删除不需要的文件

6 w* W2 Z6 I8 u6 u  _. }6 \

9 n9 b# W/ j* z* z        而对于一些其他文件，例如下图中STM32CubeMX生成的不同编译器下的汇编启动文件，如果我们要实现Keil5和STM32CubeIDE都可以编译的话，则不能删除，我们可以将不需要的文件排除在工程外。如下图所示，对着文件夹或者文件右键。

# c: s/ v% o4 q% F  K

排除文件夹

" V# f4 G5 ~* j! m5 M2 J# j7 w: T. y

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

1 g5 a2 l% [0 B, }3 H% b, R6 l, b0 c4 Y

/ u" K- U- w, b  C7 c: u. u
& F2 s5 T6 f& n8 N5 C- z, E

排除文件夹选项

; r/ {+ j# k2 ~* r: T

' h; r4 V5 N6 \. q        注意到这时候被排除的文件就会有特别的标志显示。
3 [. w) ?, G% k( I( p

6 B3 h/ k; Q; j& n0 Q1 A, |4 O

排除的文件夹

! g* C( J2 n+ V/ I+ a
2 A; \, m) l" |! B/ J
        为了便于说明，对比删除和排除后目录差异。，Core文件夹下删除了system_stm32f1xx.c,该文件在Drivers文件夹下也有一份，两者只能存在一份，否则编译器会报错，也可以保留Core文件夹下的，看个人习惯。
9 k3 j' T( m; Y8 S$ d& H/ E
0 i$ j% \$ d# W9 s" B

Core文件夹对比

# N! Z4 T- t) M+ O
8 Z; G. D2 R. z/ C( I
        Drivers下第一级目录，没使用到的全部删除。
& H9 \2 M4 k+ G# ~

. L  H9 Y8 T$ y/ |( F2 J  \

Drivers文件夹对比

, j  v; b/ E: v& C* ]5 ]
# u+ N2 O- ]/ e# j4 Y! ?) E" F0 r
        CMSIS文件夹下，删除了Core文件夹下的Template，删除了其他系列芯片的启动文件和.h文件。而Keil使用的汇编文件存放路径arm，IAR使用的汇编文件存放路径iar，则将其排除。

+ B! X7 _1 V6 V$ v8 t3 O4 d

, H, R( b' J' p8 B6 k

CMSIS文件夹对比

; ~- K& R: ]$ E" \; H: g
2 @6 J( ~- [# u        STM32F1xx_HAL_Driver文件夹，Inc文件不用动，因为都是.h文件，Src文件夹下除了使用下图所示使用到的HAL文件，其他全部排除。

8 f" x4 M$ i/ j& ?7 l7 T

% {: Z1 V% c1 B4 l  Q2 }4 }) |+ h

HAL Driver文件夹

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

+ b: x' V6 k# R, T6 u* E1 m& g7 a

" I; y, A' i2 g. m: X" R

STM32CubeIDE编译通过

, d" f4 W1 R' x7 s; J7 G
4 ~) g" O, b/ y1 K% A% C( S
3 ^) q) T7 {9 V" E/ s2 Q        此时切回到Keil尝试编译，编译器报错找不到Core文件夹下的system_stm32f1xx.c文件，因为前面已经把他删除了，重新将Drivers文件下的system_stm32f1xx.c文件引入，此时Keil也能编译通过。

/ L6 }: Y8 d( o

Keil编译

, Z, ^' w1 b  R4 p9 d+ T9 T
6 ]  H5 q5 E2 G2 o. D
        如果需要调整优化等级，则可以再下图所示位置调整。
' a" u, c: L3 s
( ^6 [9 V  u& m) }/ L7 H

9 _$ s1 \0 |: ?9 }3 Q

调整优化等级

1 W( c  Q& X9 m. b
3 I" r/ J, [" r4 e/ G3 t& C! Q- t6 E: V. K
8 p7 }5 R* t3 L+ r0 `1 p        除了以上内容以外，我们还需要将工程内所有路径设置成相对路径，这样才可以像Keil那样，随意将代码放到任何位置都能编译，按下图所示步骤，将路径从绝对路径转换为相对路径。

/ Q: T& x+ h6 T+ c: {' R  E6 Q

Linked Resources设置为相对路径

6 p+ A1 J! y5 p; J9 R# ?

4 n3 A8 i- t/ r- A        前文提到的Id文件，此时已经是相对路径，如果不是的话也需要修改为相对路径。
! @3 q+ a$ P$ d" e( H. Y
& g3 N0 t$ m  s0 l/ M

Id文件路径

5 _; R4 t3 H5 a. v0 ~; v" n# k
9 n9 \  l# |2 `. g. ~& X; k$ N        查看工程文件夹内，除了最开始拷贝过来的这三个文件，其余都是编译过程中产生的文件，提交代码或者拷贝到别处时都可以删除。

        额外需要注意的是，STM32CubeIDE只能存在一个相同名称的工程，所有拷贝到别处时还需要删除已有工程，只删除工程但是不删除硬盘数据，然后在别的路径下打开就可以自动导入。
! l: W: U9 b$ G; Y, X4 Q  h
- Y; ?- R2 ?) G& f; g1 X        针对一个相同名称的工程问题，工程取名时最好也有些讲究。
( f2 D: N% w  N8 a' N: ~

/ ^+ P- {* Y& b9 H% C8 T
# B3 V8 t6 i3 s! l: r7 q+ a

编译后文件夹内容

0 m1 T3 S+ Y  W0 M4 d8 P6 E& Q
2 V- f0 [4 A) Q$ \- _
        这样，通过外链文件夹、排除文件和设置相对路径，就可以不改变原有工程目录的情况下，将已有工程迁移到STM32CubeIDE中。