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

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

; c* {/ [: \5 x, q8 U6 `

STM32F103C8T6亮灯程序

% h# W2 g* J$ L2 Q3 Z

        如图所示，该文件夹内容是STM32CubeMX自动生成的，我们在该路径下面创建一个STM32CubeIDE_Test文件夹，用来存放STM32CubeIDE相关工程文件。
- _" \8 b& H" H$ F; P. {

# x# Z; Y$ h  }: k2 t& x% |) h& S

创建工程文件夹

! Y! F4 V- g$ v# D$ \3 Z        参照上一章，先使用STM32CubeIDE创建一个STM32F103C8T6的工程，STM32CubeIDE的Workspace中的这三个文件就是我们需要的，这三个文件记录了STM32F103C8T6芯片的一些相关信息，我们可以直接拿来用，很方便。将其拷贝到上面在STM32CubeMX中创建的文件夹内。

& V2 K+ p  c: G# }, F, K1 a

STM32CubeIDE默认生成的文件

- S. p8 o3 O! q; w2 \" P- d

这里简单介绍下这三个文件：

3 \6 l0 j, |* L" h% D; s3 S.cproject ： 该文件是CDT插件的工程描述，CDT是Eclipse 的 C/C++ 开发工具。
3 J4 D/ o1 N6 i: @
.project：    该文件是Eclipse的工程描述，毕竟STM32CubeIDE就是基于Eclipse的。

STM32F103C8TX_FLASH.ld  ：该文件定义了程序入口地址，定义Flash、RAM中代码和数据的存放位置，将来搞Bootloader的时候就可以在这文件里面修改代码存放的起始地址。
/ A/ ^4 O! y! q5 w! m
8 [9 `8 R# I# T8 J" W' h; E

6 e+ l, E  R* n' [. q/ Q
$ x) o; U- q$ J7 R7 s2 C( }

拷贝文件到文件夹

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

% a$ m0 D% p2 m( X8 ~% Q
/ ~. ^9 a' O' r

删除工程

  Z, X, _( d1 T! U% ^: q& l

, o) e5 y# Z7 S9 I        进入我们在STM32CubeMX下创建的文件夹，点击.project，稍微等待一下就可以看到STM32CubeIDE已经导入了该工程。

7 a: g* {, V# S

8 s0 U/ P; G5 J% I# u" ^# v

导入工程

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

# O; ~5 I* ~' l' m+ a7 X( D
6 y& Y4 T) `5 C/ r

空工程

* P2 k& `4 H: d$ J  X% n

         像Keil一样，我们先将工程文件引入进来，如图所示，先选中工程，然后打开工程属性。
+ ?. G# l/ r$ s+ M$ H3 `
/ U0 ?1 v& F* B' ^0 @8 R

! \4 i; k. N! ]# n# @

打开工程属性

! @# u) j' E: C2 u$ Y; r( w
, _4 F; X7 o. `8 D
+ K9 s+ l3 m8 B2 S9 \  c* a+ m/ c' f        依次按下图所示步骤，将Core文件夹和Drivers文件夹链接到工程中，这两个文件夹存放了STM32的相关代码，而MDK-ARM主要存放了Keil5的相关工程文件，我们不链接。需要注意的是，链接路径里不能再次包含工程文件，如果这里我们直接链接这个目录的上层文件夹目录的话，将不能链接。
( h0 B; l% X( L. C  h

引入文件

5 j1 g# p/ m2 h        链接信息确认退出后就能在右侧看到引入的工程文件吗，而且外链的文件夹下面有个小箭头区分。
; j5 g( \) C4 U* ~
) U/ u2 C+ t7 G

$ f' n- d, t# A6 G# B! E! {' Q
0 x$ N) A) R4 _+ F+ G* h) S

添加文件到工程目录

' B* h$ s8 x  X! h' J; L( l& {, _6 |
" M9 _- t" K3 R" L4 X$ ]# b6 ?        在Keil中，我们需要设置头文件包含路径，在STM32CubeIDE中也一样，注意这张图里已有的是上一个工程自带的，我们把全部删除后再添加。
4 M6 G( x& ^* H
: d) E+ m2 M6 v1 {* }; D! M7 F; @

9 s) l* ?; h* ?# f+ m( K% W0 v
: x6 u6 n/ ^2 n( c( K- \

添加包含路径

$ @3 ^5 ~: f9 u+ v* o) a$ V
7 V/ S! A; I9 U  d
2 P# U! G8 S! [! S6 g3 R) v        添加完成后如下图所示，主要为HAL库的头文件、ARM内核的头文件。

; W# [/ i' n/ ?: S8 `
9 T5 [: W2 j$ y7 X" G

头文件路径

( W; [5 u) C, w0 _% ?
' V3 E% e; F( Z6 T1 Z# F5 c
        添加预处理符号，在Keil5中也有该设置，声明一些全局的宏定义，主要是给HAL库使用，这里创建工程的时候已经包含了所需要的USE_HAL_DRIVER和STM32F103xB两个关键预处理，如果还有别的预处理，在此处新增即可。
* y1 T7 m  F7 I2 ^' C
4 `7 M; d- ], m" L, m; |/ R

& ^5 W" Q% B& D2 D1 `5 ^
; o9 W2 l! v* r6 y

预处理符号

" y9 y0 x% ]  H0 c0 _0 J& i9 `, z
# f+ ?, b# [  `  g5 V        此时可以尝试编译一下，毫不意外，会有很多报错，由于STM32CubeIDE的特性，会将文件夹下所有的文件引入进来，而有一些不是我们需要的，这些不需要的文件都进行了编译，当然会报很多错误，我们可以通过删除不需要的文件或者排除文件在工程外两种方式，去掉不需要的文件。

        第一种是删除，例如下图这些文件，都是STM32CubeMX多余生成的，此处无用，直接右键删除。此处删除将会直接删除硬盘上的文件，谨记。

删除不需要的文件

3 i  N$ P) @; [; ]! Z
$ m$ M8 Q$ G) l' M: Z2 t+ g& }! ~# a
7 {4 A- w+ h9 v. S3 b9 x& G        而对于一些其他文件，例如下图中STM32CubeMX生成的不同编译器下的汇编启动文件，如果我们要实现Keil5和STM32CubeIDE都可以编译的话，则不能删除，我们可以将不需要的文件排除在工程外。如下图所示，对着文件夹或者文件右键。
; g% Q/ {( N% `; C( H$ C' a4 _( H& J- j

排除文件夹

0 f9 F& E" I8 M4 v6 W- f7 K3 W: B

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

排除文件夹选项

$ [3 |) \9 Z% C0 L: }( C' W
        注意到这时候被排除的文件就会有特别的标志显示。
( w1 C7 o0 X# b' U/ U( C( w
) y+ f) r! F0 Z& |9 K. i

* a- m9 ?! P5 R. Z

排除的文件夹

7 ?8 v# r5 T" S2 I: i! F
3 c5 }, R4 Z) l" ]6 `
        为了便于说明，对比删除和排除后目录差异。，Core文件夹下删除了system_stm32f1xx.c,该文件在Drivers文件夹下也有一份，两者只能存在一份，否则编译器会报错，也可以保留Core文件夹下的，看个人习惯。
2 ]6 A7 F: B3 p6 _* U
( c3 g3 ]4 b1 M9 W9 E

. M( Z& Z) F6 S

Core文件夹对比

( |; w0 {( U* }$ T9 }
* S8 X, `( n( ~, `) ?
        Drivers下第一级目录，没使用到的全部删除。
$ ]) o4 b9 w% K1 }, q
# c( W! \# x7 U, M, Z6 w# x* o

Drivers文件夹对比

5 e2 j5 ]/ k6 l. @        CMSIS文件夹下，删除了Core文件夹下的Template，删除了其他系列芯片的启动文件和.h文件。而Keil使用的汇编文件存放路径arm，IAR使用的汇编文件存放路径iar，则将其排除。
) i& K1 l+ \. ~, a" ^0 c

0 s3 F* b6 P) O: d9 Q$ @9 }

CMSIS文件夹对比

# I$ y% {( J: Q& L- y9 x

$ b$ u# o: _1 N/ _, M7 Q; K! Z0 g        STM32F1xx_HAL_Driver文件夹，Inc文件不用动，因为都是.h文件，Src文件夹下除了使用下图所示使用到的HAL文件，其他全部排除。

3 T4 _8 ]# {. f0 N  V

HAL Driver文件夹

8 c4 W7 d- [/ N: \

5 \; \+ C; t" y0 N4 d        经过以上步骤，此时再尝试编译，编译通过，生成了Debug文件夹，参照上一章内容，此时下载就可以运行。
  r( ]- ^4 g9 q' w  \: z% w

7 c" \1 J  [; v7 \* D! r9 e

STM32CubeIDE编译通过

, ?# p* I0 |! v6 ~) J* w+ ]% }
        此时切回到Keil尝试编译，编译器报错找不到Core文件夹下的system_stm32f1xx.c文件，因为前面已经把他删除了，重新将Drivers文件下的system_stm32f1xx.c文件引入，此时Keil也能编译通过。
$ U1 Z8 X7 S' D' [1 b, @* x
* w" l9 _* J9 g0 H+ ]" w: q

) R; }# ?7 C$ w; n2 s4 K2 Y

Keil编译

6 w0 a; R. s1 F+ r# @4 w

$ w; W+ F5 |3 |' `        如果需要调整优化等级，则可以再下图所示位置调整。

+ k5 o$ i% O, K

. C  i) W) _4 o/ i. e) f4 N' [
( p, [  L5 `" n1 s3 n6 f

调整优化等级

, c3 ]6 G# u6 d0 \2 f" }. ?
, p& D) e+ O& d( @5 q7 b7 ?
3 D3 D  `3 B; E: V: z        除了以上内容以外，我们还需要将工程内所有路径设置成相对路径，这样才可以像Keil那样，随意将代码放到任何位置都能编译，按下图所示步骤，将路径从绝对路径转换为相对路径。
! k  P) O  i& r# H( ^7 L* A+ l
$ R- Z* L& H- N1 n6 u1 I

" E4 f4 Q5 Q- @& e% @, b
' Q' ^$ l- @; J

Linked Resources设置为相对路径

6 _6 N) u# u. T! E$ J5 v

        前文提到的Id文件，此时已经是相对路径，如果不是的话也需要修改为相对路径。
$ H* o8 Y" U0 V# b

0 n0 c6 U4 g" p* \( R, T) ]: [

Id文件路径

" A) u% ^- X* u8 _+ j5 B4 M8 H
" \% z# y& Q# b
# q5 {5 E% t$ S' Q& j( M- ~        查看工程文件夹内，除了最开始拷贝过来的这三个文件，其余都是编译过程中产生的文件，提交代码或者拷贝到别处时都可以删除。

        额外需要注意的是，STM32CubeIDE只能存在一个相同名称的工程，所有拷贝到别处时还需要删除已有工程，只删除工程但是不删除硬盘数据，然后在别的路径下打开就可以自动导入。

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

$ B  ?9 L$ {6 B, s# i5 G
: \+ L3 w/ ~' O9 W

编译后文件夹内容

0 v6 m9 o. k( v4 u. c4 j' O9 b: ]
        这样，通过外链文件夹、排除文件和设置相对路径，就可以不改变原有工程目录的情况下，将已有工程迁移到STM32CubeIDE中。