对于初学者来说，刚开始学习STM32时候都使用的是Keil，很多项目都是在Keil环境下编译和调试的，这一章将描述如何将Keil工程迁移到STM32CubeIDE中。
, m7 K) u1 E  L7 f0 w
          对照Keil下的新建工程步骤，创建工程、引入工程文件、添加预处理指令、添加头文件包含路径等步骤，STM32CubeIDE中也大同小异。 为了便于说明，我用STM32CubeMX生成了一个Keil5环境下的STM32F103C8T6亮灯程序，然后将其迁移到STM32CubeIDE中。

3 i) M  b+ n5 e) Q

STM32F103C8T6亮灯程序

        如图所示，该文件夹内容是STM32CubeMX自动生成的，我们在该路径下面创建一个STM32CubeIDE_Test文件夹，用来存放STM32CubeIDE相关工程文件。
4 z% A' {1 {/ N. N; v) _
" w5 x* A( y5 m/ l7 e3 M, A4 U9 ^

创建工程文件夹

3 s8 _# ^$ d7 v9 m& u9 @
* p* G! A' o# q6 x
0 v4 y) Q: A3 T/ P# U& P# K        参照上一章，先使用STM32CubeIDE创建一个STM32F103C8T6的工程，STM32CubeIDE的Workspace中的这三个文件就是我们需要的，这三个文件记录了STM32F103C8T6芯片的一些相关信息，我们可以直接拿来用，很方便。将其拷贝到上面在STM32CubeMX中创建的文件夹内。
( W% c4 ?; [' q; U" l
0 m$ ?* V, x0 k. W6 N& t% u! v

2 Q" r! w0 @# T3 f+ x  H4 B
* u9 y+ ^4 N$ D

STM32CubeIDE默认生成的文件

5 g2 U3 V  L! P1 g& }  T: S' z1 c
这里简单介绍下这三个文件：
6 {  ~) F5 v+ L" e
. t6 J  g( a* q6 Z1 d3 p' D.cproject ： 该文件是CDT插件的工程描述，CDT是Eclipse 的 C/C++ 开发工具。
9 i1 r8 m) }' r- A* A6 O* J
% C" _/ h7 [  n  h4 X% @.project：    该文件是Eclipse的工程描述，毕竟STM32CubeIDE就是基于Eclipse的。

STM32F103C8TX_FLASH.ld  ：该文件定义了程序入口地址，定义Flash、RAM中代码和数据的存放位置，将来搞Bootloader的时候就可以在这文件里面修改代码存放的起始地址。
) H; y+ e' P9 t0 a' a: i
- b4 n6 A# x: m! Y$ N

, c' c+ H) z! D  |

拷贝文件到文件夹

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

( ^/ c4 P! D% |/ {- @

% R" l' s/ w. z$ F' u: K, [- f% b& z8 [

删除工程

- n  O4 f9 }5 L

/ {2 [4 K3 v( n' `3 t' s# a: n; Q        进入我们在STM32CubeMX下创建的文件夹，点击.project，稍微等待一下就可以看到STM32CubeIDE已经导入了该工程。

& c. s, w# a# @' ]  X

! o, q3 }2 k& K+ @* n' i
0 u% L2 E* v8 _0 q' ~8 ~# U" Q5 G1 I' M

导入工程

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

9 c; q$ c5 X7 Q- U

空工程

3 o% l, J5 z. n" V( u. q
% j+ @: ?% h0 s2 Z& _  Q3 y
0 E. z- O9 l: a; v7 f  \1 T- P         像Keil一样，我们先将工程文件引入进来，如图所示，先选中工程，然后打开工程属性。

& N* {- b. g( ?

: `& K6 I( O5 @$ Q8 [# i+ {

打开工程属性

" j3 J7 `2 ^' u+ W0 b3 E

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

  J1 s+ v& [, N8 s, D

引入文件

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

+ l- ~8 c1 @: g4 A

' h2 W8 w- Q. L# S+ C+ H
9 f9 C4 @9 W" F9 V) ?

添加文件到工程目录

/ R1 o  V0 ^$ t& q' ]- F

        在Keil中，我们需要设置头文件包含路径，在STM32CubeIDE中也一样，注意这张图里已有的是上一个工程自带的，我们把全部删除后再添加。
- A/ X6 a' C6 i! G: J

! Y( l1 J0 w+ N0 D
2 Q. z% p6 L  q* L1 `! T1 q  F; d( R

添加包含路径

! j+ h1 H. U2 F5 L0 }
/ ?$ H% W- K) i        添加完成后如下图所示，主要为HAL库的头文件、ARM内核的头文件。
4 h/ I) X4 W$ J2 y: q6 @

2 b4 V% E2 h, n0 Y" w* G5 w  W* g

头文件路径

- p4 [& B4 H( ?/ ]  W) t
0 w2 ?2 v. c' O5 Q, {* {
        添加预处理符号，在Keil5中也有该设置，声明一些全局的宏定义，主要是给HAL库使用，这里创建工程的时候已经包含了所需要的USE_HAL_DRIVER和STM32F103xB两个关键预处理，如果还有别的预处理，在此处新增即可。
" h6 J" w5 O4 D9 S) A
2 f* k) s! H' a1 O2 N

9 q' `) G3 u' E

预处理符号

1 c  ?$ ?3 |. A% M
/ m; p6 b3 c9 ]0 y* j8 m
$ j! Z7 I; r+ Y# }+ ]        此时可以尝试编译一下，毫不意外，会有很多报错，由于STM32CubeIDE的特性，会将文件夹下所有的文件引入进来，而有一些不是我们需要的，这些不需要的文件都进行了编译，当然会报很多错误，我们可以通过删除不需要的文件或者排除文件在工程外两种方式，去掉不需要的文件。
$ Y) [% y( @- m6 o  Z% @
        第一种是删除，例如下图这些文件，都是STM32CubeMX多余生成的，此处无用，直接右键删除。此处删除将会直接删除硬盘上的文件，谨记。
$ _0 N8 k; o4 x! d$ ?$ Q; o
; C1 t( G" m8 U. H4 h

$ g; _& L% K& f% F" a
% b, D$ |% P; C; x# d% J

删除不需要的文件

' e3 P) U; _* p% l* ]# H0 E
        而对于一些其他文件，例如下图中STM32CubeMX生成的不同编译器下的汇编启动文件，如果我们要实现Keil5和STM32CubeIDE都可以编译的话，则不能删除，我们可以将不需要的文件排除在工程外。如下图所示，对着文件夹或者文件右键。
: _2 x: `- n9 J% s( p, Y6 c

% I( e: J+ ]+ f0 ?5 k9 @0 w

排除文件夹

: l$ i, x9 L2 W        然后在弹出的窗口全选，也可以用该方法来切换不同配置下工程编译包含文件，此处的Debug和Release就是两个不同的配置。
8 L  Q" H9 u  B3 k$ n) o8 D

5 r+ w" ~+ _5 r

排除文件夹选项

( {- K1 P0 q3 k9 u( l- I

        注意到这时候被排除的文件就会有特别的标志显示。
/ ]7 F3 n' k( U

+ T3 G& ~+ i) G' g

排除的文件夹

# ?5 o  K1 V. I. a# I

        为了便于说明，对比删除和排除后目录差异。，Core文件夹下删除了system_stm32f1xx.c,该文件在Drivers文件夹下也有一份，两者只能存在一份，否则编译器会报错，也可以保留Core文件夹下的，看个人习惯。

' R+ o  R" X6 K/ A
9 Q9 X; h: }: D$ F! [: d9 m4 S

Core文件夹对比

: c2 Y% `* R! |4 I' a$ g$ f
        Drivers下第一级目录，没使用到的全部删除。

" Z6 f* K/ I8 F3 A8 S

: V# w$ d+ p* Q% _9 q6 f

Drivers文件夹对比

& S$ j  j' z- p2 W" C  m
" R+ g& o/ w6 a4 K6 H9 x
8 m  W- T' B) K! @* J        CMSIS文件夹下，删除了Core文件夹下的Template，删除了其他系列芯片的启动文件和.h文件。而Keil使用的汇编文件存放路径arm，IAR使用的汇编文件存放路径iar，则将其排除。

" F. P* U+ \4 \7 s5 S) R# _

CMSIS文件夹对比

6 D0 V6 ^* g" j& J! o5 {& m4 e        STM32F1xx_HAL_Driver文件夹，Inc文件不用动，因为都是.h文件，Src文件夹下除了使用下图所示使用到的HAL文件，其他全部排除。
- V$ {% D, K' c
' H' t# e9 {8 E' I+ L' L6 [3 v

- H9 `, ]$ j9 b

HAL Driver文件夹

9 N- o( e/ J+ ~* P; T* V6 C- m" E
        经过以上步骤，此时再尝试编译，编译通过，生成了Debug文件夹，参照上一章内容，此时下载就可以运行。

; K% v* n; W5 m- i: r, ~

STM32CubeIDE编译通过

$ ~0 {# [  n4 z) m# A" m$ a& H
! ]8 o4 K* D# d
; D& o! ]; M, b  q% \/ v        此时切回到Keil尝试编译，编译器报错找不到Core文件夹下的system_stm32f1xx.c文件，因为前面已经把他删除了，重新将Drivers文件下的system_stm32f1xx.c文件引入，此时Keil也能编译通过。

0 S3 }$ n5 s+ o5 w% _: U

Keil编译

5 Y8 Z0 A, h- m3 u" @8 _        如果需要调整优化等级，则可以再下图所示位置调整。

' e0 W$ n; y+ U3 t* K8 V' v/ w

调整优化等级

+ b4 X1 |7 J/ i& o0 \/ B
; r: G8 e0 ~( [2 G# [+ i3 r( [8 V
        除了以上内容以外，我们还需要将工程内所有路径设置成相对路径，这样才可以像Keil那样，随意将代码放到任何位置都能编译，按下图所示步骤，将路径从绝对路径转换为相对路径。

9 R  h5 Y, T& y2 l! ?' y: D

Linked Resources设置为相对路径

        前文提到的Id文件，此时已经是相对路径，如果不是的话也需要修改为相对路径。
& A0 Y2 ^# o8 E& K

Id文件路径

        查看工程文件夹内，除了最开始拷贝过来的这三个文件，其余都是编译过程中产生的文件，提交代码或者拷贝到别处时都可以删除。

        额外需要注意的是，STM32CubeIDE只能存在一个相同名称的工程，所有拷贝到别处时还需要删除已有工程，只删除工程但是不删除硬盘数据，然后在别的路径下打开就可以自动导入。
" k# S* d2 f( c& H/ i
        针对一个相同名称的工程问题，工程取名时最好也有些讲究。

( z. @3 w  E& W# N+ D

编译后文件夹内容

  n% X6 B3 j; S9 @% J
        这样，通过外链文件夹、排除文件和设置相对路径，就可以不改变原有工程目录的情况下，将已有工程迁移到STM32CubeIDE中。
5 j- `! O$ R, E8 T8 T( r/ {
* \7 C1 Z4 W9 Y( q8 s
( |8 H4 H6 D, V1 O# e