对于初学者来说，刚开始学习STM32时候都使用的是Keil，很多项目都是在Keil环境下编译和调试的，这一章将描述如何将Keil工程迁移到STM32CubeIDE中。
8 @5 V1 @# L8 R4 K% s0 B
4 v8 {9 O8 ~+ I          对照Keil下的新建工程步骤，创建工程、引入工程文件、添加预处理指令、添加头文件包含路径等步骤，STM32CubeIDE中也大同小异。 为了便于说明，我用STM32CubeMX生成了一个Keil5环境下的STM32F103C8T6亮灯程序，然后将其迁移到STM32CubeIDE中。

: z. d1 |# X% d. M
  y! ~# _6 c: R9 i2 k4 Q9 O6 R

STM32F103C8T6亮灯程序

9 k3 ^8 X5 T4 f; s
# w6 S0 z9 s5 v) ?* s3 {. Z        如图所示，该文件夹内容是STM32CubeMX自动生成的，我们在该路径下面创建一个STM32CubeIDE_Test文件夹，用来存放STM32CubeIDE相关工程文件。
* I8 r  M8 @: u" F* R0 v) j5 {% a
7 Y: v7 m3 T5 ~2 a  Y

. l/ g$ r9 e9 }5 u/ g) b5 I7 J
1 }- D* I2 R" U" R" ]0 `3 l) B& K

创建工程文件夹

+ U3 c- ]# R8 G0 q$ A        参照上一章，先使用STM32CubeIDE创建一个STM32F103C8T6的工程，STM32CubeIDE的Workspace中的这三个文件就是我们需要的，这三个文件记录了STM32F103C8T6芯片的一些相关信息，我们可以直接拿来用，很方便。将其拷贝到上面在STM32CubeMX中创建的文件夹内。

) o- K( x/ c  l0 \; V3 d

, u& M. k8 y7 ?0 y
( T* }7 G9 i/ X. I% s8 f( ?2 F

STM32CubeIDE默认生成的文件

/ |0 i. G! V4 D/ T/ N% z
这里简单介绍下这三个文件：
) I9 X8 \: Z2 F  A( [, i
.cproject ： 该文件是CDT插件的工程描述，CDT是Eclipse 的 C/C++ 开发工具。

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

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

7 G/ y; p7 g, P

拷贝文件到文件夹

: x6 m! ~1 {7 [0 z3 B

        然后删除STM32CubeIDE中刚刚创建的工程，因为STM32CubeIDE只能存在一个相同名称的工程。在工程名上右键然后Delete，软件会提示是否删除硬盘上的数据，这里我们先不删除。
  L( g( @) w$ M6 q! N9 C$ g
% O) l+ m* ~! I' x

删除工程

+ q, i# s, m4 d" u
. P3 u: _# v/ q; t
        进入我们在STM32CubeMX下创建的文件夹，点击.project，稍微等待一下就可以看到STM32CubeIDE已经导入了该工程。
% r( O1 R2 E6 y

导入工程

7 h! A, F6 l/ ?, h, l! ?        STM32CubeIDE默认会加载和工程文件同一路径下的所有文件，这时候工程里面全是空的，我们只能看见刚刚三个文件中的STM32F103C8TX_FLASH.Id文件，我们需要做一些操作。
- ^( `5 q5 K8 `
9 n7 q4 k6 w1 V# P- \/ X8 u

2 x8 P$ ?* A! O0 n) Z

空工程

         像Keil一样，我们先将工程文件引入进来，如图所示，先选中工程，然后打开工程属性。
7 g. w# {0 L1 L- O7 V

" ~0 l. n9 S2 q' P* H

打开工程属性

+ Q1 {+ R' ]+ \  K) h

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

* j# g3 K  f/ h! L$ d

) u% ~1 g, O  W: q4 D

引入文件

9 t1 E& f. x2 T6 M, A" l9 l        链接信息确认退出后就能在右侧看到引入的工程文件吗，而且外链的文件夹下面有个小箭头区分。
2 v2 d& `: P! P- l2 C; k0 J
) }5 g$ G; C- V# U) Q7 F$ z

添加文件到工程目录

7 [; d: i5 h8 v$ ?
1 z" X: G; q" z, w        在Keil中，我们需要设置头文件包含路径，在STM32CubeIDE中也一样，注意这张图里已有的是上一个工程自带的，我们把全部删除后再添加。
( z8 a  ~! L3 c7 n" v+ M

6 Q* s8 o0 [) T$ Q  O* O% g

添加包含路径

/ K/ u3 w$ f$ m# a
# @! Y& G* b4 Y/ y% ^" q        添加完成后如下图所示，主要为HAL库的头文件、ARM内核的头文件。
% H' _' r3 {6 l' P5 B. f: R) c

; P! R2 Y' C" G

头文件路径

/ W3 R% S9 U) F! x8 o
, J' r, e2 E& P# q
        添加预处理符号，在Keil5中也有该设置，声明一些全局的宏定义，主要是给HAL库使用，这里创建工程的时候已经包含了所需要的USE_HAL_DRIVER和STM32F103xB两个关键预处理，如果还有别的预处理，在此处新增即可。

2 ^1 K* C# n( S7 H' f
* k0 x6 P! _5 O# F0 K2 `

预处理符号

9 D1 I/ f+ E* G" d" @5 I
8 @- O+ I7 @3 c
        此时可以尝试编译一下，毫不意外，会有很多报错，由于STM32CubeIDE的特性，会将文件夹下所有的文件引入进来，而有一些不是我们需要的，这些不需要的文件都进行了编译，当然会报很多错误，我们可以通过删除不需要的文件或者排除文件在工程外两种方式，去掉不需要的文件。

        第一种是删除，例如下图这些文件，都是STM32CubeMX多余生成的，此处无用，直接右键删除。此处删除将会直接删除硬盘上的文件，谨记。
7 A4 i& x2 Q0 [- g; `7 O

9 d- W) l+ l3 L2 L0 w

删除不需要的文件

9 |: `. C. i  C+ S0 y, U; ~        而对于一些其他文件，例如下图中STM32CubeMX生成的不同编译器下的汇编启动文件，如果我们要实现Keil5和STM32CubeIDE都可以编译的话，则不能删除，我们可以将不需要的文件排除在工程外。如下图所示，对着文件夹或者文件右键。

/ a0 C) k3 X' s3 a- X  W  _

排除文件夹

4 n) E1 T3 M9 V, z* X
        然后在弹出的窗口全选，也可以用该方法来切换不同配置下工程编译包含文件，此处的Debug和Release就是两个不同的配置。
* W1 h# P3 P# @  u/ f
2 [% |1 {- i. d1 k$ k! }& R

排除文件夹选项

: c( O3 s! y/ E
* w5 N9 w0 ]- h7 n        注意到这时候被排除的文件就会有特别的标志显示。

* t5 d7 ^; Z. x- P

排除的文件夹

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

- o% u* ^7 q7 ^% V6 Z

Core文件夹对比

; x9 Y+ A" c* v9 D
+ T4 X2 p1 J0 }* D2 x3 y        Drivers下第一级目录，没使用到的全部删除。
. c; \; j' c2 c. X' C
1 X6 T) N( B# r  I, @' A# V

Drivers文件夹对比

        CMSIS文件夹下，删除了Core文件夹下的Template，删除了其他系列芯片的启动文件和.h文件。而Keil使用的汇编文件存放路径arm，IAR使用的汇编文件存放路径iar，则将其排除。
* ]3 k* w8 {; ~$ v9 D8 ?
* K* A( [! `2 `( \# e

8 E& _- Q& ]' c# _. Y: O- J

CMSIS文件夹对比

; {* g$ E$ O5 B( h" E' }, f
( k1 [" S  a) |; q        STM32F1xx_HAL_Driver文件夹，Inc文件不用动，因为都是.h文件，Src文件夹下除了使用下图所示使用到的HAL文件，其他全部排除。
* E* t/ I+ A7 U- ~0 ^

  q; E9 D0 w4 u" B' J& d8 z

HAL Driver文件夹

( k* j& D1 H: N

( e5 S/ Z, s& Z9 a% x' b# W6 J* {        经过以上步骤，此时再尝试编译，编译通过，生成了Debug文件夹，参照上一章内容，此时下载就可以运行。
& ?) G/ Z+ {8 Q) [: ^; M

$ l6 |- I5 C9 f3 U+ K6 U  J2 [2 J8 C

STM32CubeIDE编译通过

# z& a" V2 p! \- Y* B( q& z9 w% A  q
1 i* F& O2 |( o3 p        此时切回到Keil尝试编译，编译器报错找不到Core文件夹下的system_stm32f1xx.c文件，因为前面已经把他删除了，重新将Drivers文件下的system_stm32f1xx.c文件引入，此时Keil也能编译通过。
) W9 h# k: B1 O& U9 W) n
" r% h& V" P) @9 t8 R

- P9 c, Y2 g# }* A9 ]& }% i

Keil编译

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

6 r  M- ?1 X+ g) O1 f7 y

调整优化等级

1 e7 |4 Q& O* N' U
5 X/ K  A6 X/ N/ a) o# Z3 _
        除了以上内容以外，我们还需要将工程内所有路径设置成相对路径，这样才可以像Keil那样，随意将代码放到任何位置都能编译，按下图所示步骤，将路径从绝对路径转换为相对路径。

* s: U& l& V# \+ z

, n& Z) j4 }4 ^& R; y3 o" @7 \

Linked Resources设置为相对路径

4 v, M1 s3 n6 F; a% y
        前文提到的Id文件，此时已经是相对路径，如果不是的话也需要修改为相对路径。
* @2 K1 t0 l& K% W; g- M# o
/ v/ D7 z" w( O7 _" |

Id文件路径

) G' p0 Y9 I) t7 a; v; y; X

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

        额外需要注意的是，STM32CubeIDE只能存在一个相同名称的工程，所有拷贝到别处时还需要删除已有工程，只删除工程但是不删除硬盘数据，然后在别的路径下打开就可以自动导入。
) Q: i, v6 b* N" o, U1 v
        针对一个相同名称的工程问题，工程取名时最好也有些讲究。
0 `" P  u' z' g& j' C8 }
0 {9 R/ E' f/ i5 ^) i9 f7 v

- Z2 k4 i+ x+ k: E

编译后文件夹内容

% N, U# _) _2 _7 `( Y1 Z
        这样，通过外链文件夹、排除文件和设置相对路径，就可以不改变原有工程目录的情况下，将已有工程迁移到STM32CubeIDE中。
$ \9 _) F$ ^) }) O3 [
作者：bili_42806779649

: z4 J$ Z- a$ t& D" F