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

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

$ s" {0 d/ D, }  d# A

STM32F103C8T6亮灯程序

1 q, V# z2 T. H6 A/ H4 V5 C9 ^

3 R& s. p! A8 [! [* O- n        如图所示，该文件夹内容是STM32CubeMX自动生成的，我们在该路径下面创建一个STM32CubeIDE_Test文件夹，用来存放STM32CubeIDE相关工程文件。
: }8 ]0 \- @9 {, O
% i+ P, S- j! [0 ]. |# _* Z

创建工程文件夹

$ y/ D4 ^; i) ^5 W$ E- i! ?4 h9 @

        参照上一章，先使用STM32CubeIDE创建一个STM32F103C8T6的工程，STM32CubeIDE的Workspace中的这三个文件就是我们需要的，这三个文件记录了STM32F103C8T6芯片的一些相关信息，我们可以直接拿来用，很方便。将其拷贝到上面在STM32CubeMX中创建的文件夹内。
; L2 U$ t3 e" b; }

2 X! B0 g! f3 g

STM32CubeIDE默认生成的文件

6 o" D# |- q0 j: Z: a' D
这里简单介绍下这三个文件：

.cproject ： 该文件是CDT插件的工程描述，CDT是Eclipse 的 C/C++ 开发工具。
6 m9 d& a: Y/ O& W* v/ m, }
.project：    该文件是Eclipse的工程描述，毕竟STM32CubeIDE就是基于Eclipse的。
  Y$ P4 i% c, W' F  w; H1 I
STM32F103C8TX_FLASH.ld  ：该文件定义了程序入口地址，定义Flash、RAM中代码和数据的存放位置，将来搞Bootloader的时候就可以在这文件里面修改代码存放的起始地址。

% U4 R& Q/ E" u/ }6 o7 L$ Y1 G1 {

2 e# g: W) y" `' F7 y2 F( k; U9 ]

拷贝文件到文件夹

. k$ A8 I. g) L  ^- B' C        然后删除STM32CubeIDE中刚刚创建的工程，因为STM32CubeIDE只能存在一个相同名称的工程。在工程名上右键然后Delete，软件会提示是否删除硬盘上的数据，这里我们先不删除。
- n: j: V7 M. m0 f: f5 Z

. l& \8 }4 Z; q1 n) ?

删除工程

. U9 h4 ]( V/ l  ?" g, n        进入我们在STM32CubeMX下创建的文件夹，点击.project，稍微等待一下就可以看到STM32CubeIDE已经导入了该工程。

/ R. t- X6 i7 v0 O

6 E  ~( y' Q; S' l) \. T+ b

导入工程

# l5 L0 `  F3 T+ |        STM32CubeIDE默认会加载和工程文件同一路径下的所有文件，这时候工程里面全是空的，我们只能看见刚刚三个文件中的STM32F103C8TX_FLASH.Id文件，我们需要做一些操作。
  Z0 D" \$ d7 A8 h5 [- w6 l/ F5 _

空工程

+ w; M7 Y2 b7 D, z. }
         像Keil一样，我们先将工程文件引入进来，如图所示，先选中工程，然后打开工程属性。
- A" M+ l2 `" Z! q/ E) S6 w

; v. i/ D% g7 P( i! H

打开工程属性

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

引入文件

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

- p( H- b; j! P; K0 m
8 l) d6 E* e" N' i

添加文件到工程目录

4 F3 `$ X! v, s; V7 i8 ?
8 F3 c* T; V' C, Z% ~        在Keil中，我们需要设置头文件包含路径，在STM32CubeIDE中也一样，注意这张图里已有的是上一个工程自带的，我们把全部删除后再添加。

% U& N, T& s+ F9 d- g/ t' w

0 g0 t' a0 [% y' c3 h8 y- i2 T

添加包含路径

% w1 ?3 V( ~8 k' T! B/ M

* D# W* r/ e+ S& H        添加完成后如下图所示，主要为HAL库的头文件、ARM内核的头文件。

, `9 x2 C6 Q5 t4 I0 U; x) _4 g

7 E9 j0 d, V7 k3 Y5 N
& h+ t8 r, n  d2 T

头文件路径

        添加预处理符号，在Keil5中也有该设置，声明一些全局的宏定义，主要是给HAL库使用，这里创建工程的时候已经包含了所需要的USE_HAL_DRIVER和STM32F103xB两个关键预处理，如果还有别的预处理，在此处新增即可。

/ \$ @  F+ u& W$ R" j" z

预处理符号

' U+ D/ y1 I" u( W+ t% l) Q4 p

        此时可以尝试编译一下，毫不意外，会有很多报错，由于STM32CubeIDE的特性，会将文件夹下所有的文件引入进来，而有一些不是我们需要的，这些不需要的文件都进行了编译，当然会报很多错误，我们可以通过删除不需要的文件或者排除文件在工程外两种方式，去掉不需要的文件。
8 K; ?0 P1 H- Y
        第一种是删除，例如下图这些文件，都是STM32CubeMX多余生成的，此处无用，直接右键删除。此处删除将会直接删除硬盘上的文件，谨记。
- d" ~+ [, F: K1 r+ _
4 O6 D5 o6 [- A1 x

$ T2 B- }; Q) W, t5 J( @

删除不需要的文件

        而对于一些其他文件，例如下图中STM32CubeMX生成的不同编译器下的汇编启动文件，如果我们要实现Keil5和STM32CubeIDE都可以编译的话，则不能删除，我们可以将不需要的文件排除在工程外。如下图所示，对着文件夹或者文件右键。
% a9 d& ?6 q; E7 ~0 X$ n, f1 z

; F! j9 j$ Z% J8 c* p8 X9 o( }0 |
! w5 u- u1 \# d. I

排除文件夹

" ^- q. k; d/ e% ?2 E        然后在弹出的窗口全选，也可以用该方法来切换不同配置下工程编译包含文件，此处的Debug和Release就是两个不同的配置。
5 m  z# X4 _$ T0 j; a( L

0 \& `2 P! V, F

排除文件夹选项

8 y5 N& k* y$ b' d$ D  l        注意到这时候被排除的文件就会有特别的标志显示。

# H$ w) j$ e/ }, k# g

, z% E: u& B. m9 l

排除的文件夹

7 j0 \, I$ }4 h' k9 g) x
# d) t5 }5 Z3 Q5 M( c' g" M. }0 a
        为了便于说明，对比删除和排除后目录差异。，Core文件夹下删除了system_stm32f1xx.c,该文件在Drivers文件夹下也有一份，两者只能存在一份，否则编译器会报错，也可以保留Core文件夹下的，看个人习惯。
; h7 E  Q' O$ `7 N3 H

2 Z' H8 m; A. B: U8 W5 }% @. O: t
2 t, ~% H) F" b6 f1 X7 _  I& D

Core文件夹对比

; a) Y0 z! ^* ]- F1 t

: _& P2 R- F3 t+ P7 Q2 u        Drivers下第一级目录，没使用到的全部删除。

& f2 P! `, e* h7 p/ m" ^' Y+ w1 e7 m
3 k( d! a: Y0 R8 w3 k, k; }

Drivers文件夹对比

- P! {9 p/ ?- D, @( N
; J1 B9 C8 E+ k$ ~0 U
$ _! s+ h/ _+ X9 G        CMSIS文件夹下，删除了Core文件夹下的Template，删除了其他系列芯片的启动文件和.h文件。而Keil使用的汇编文件存放路径arm，IAR使用的汇编文件存放路径iar，则将其排除。
) k" t' t) Q4 n" c
$ w7 G1 o9 D+ L0 r

CMSIS文件夹对比

+ b; d3 }5 w  T! W& Q
9 a% L8 a- A& o# h. \$ q        STM32F1xx_HAL_Driver文件夹，Inc文件不用动，因为都是.h文件，Src文件夹下除了使用下图所示使用到的HAL文件，其他全部排除。

' k# S, t8 P# Z5 @& T

0 i( H( O  I: m, O4 V' u  w

HAL Driver文件夹

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

& S  p2 R/ P6 y2 K& z8 Y( n1 {$ X- Z

8 x) v  a( R* J% P9 C
4 f9 B3 Q. X" [! p, M" t' M* G

STM32CubeIDE编译通过

        此时切回到Keil尝试编译，编译器报错找不到Core文件夹下的system_stm32f1xx.c文件，因为前面已经把他删除了，重新将Drivers文件下的system_stm32f1xx.c文件引入，此时Keil也能编译通过。

5 Q1 z6 T) e/ N. @

Keil编译

5 `/ X& D3 q5 J0 b
        如果需要调整优化等级，则可以再下图所示位置调整。
% K. A# L+ i0 T5 x7 D: k3 ~) L5 Q
% E2 N+ l- u+ K% r: t- ~5 l

9 N6 @" p' _3 n! Q

调整优化等级

+ p; f/ H5 B+ D  b% b7 e; i; ^
& \  ]; }- f. F
        除了以上内容以外，我们还需要将工程内所有路径设置成相对路径，这样才可以像Keil那样，随意将代码放到任何位置都能编译，按下图所示步骤，将路径从绝对路径转换为相对路径。

& [9 ?$ A' t1 ]' b

Linked Resources设置为相对路径

2 y3 }  e% v! d' i' X& d
( x4 T2 A0 [  w
: _, o7 P. M% h6 b        前文提到的Id文件，此时已经是相对路径，如果不是的话也需要修改为相对路径。

2 K0 B9 Z( U1 n' Y% N

Id文件路径

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

        额外需要注意的是，STM32CubeIDE只能存在一个相同名称的工程，所有拷贝到别处时还需要删除已有工程，只删除工程但是不删除硬盘数据，然后在别的路径下打开就可以自动导入。
1 P6 f* n( D' `/ x" f, d& Q- l+ S
7 x# k( e- v, F0 G; s: B& R        针对一个相同名称的工程问题，工程取名时最好也有些讲究。

* V& S8 G3 Z. F4 u' Z. G

编译后文件夹内容

" u" z$ a- [9 B5 n6 u( {) {% m( N+ v

$ ?% F1 @8 y* t5 w9 g7 ~, q3 J0 T4 A# @        这样，通过外链文件夹、排除文件和设置相对路径，就可以不改变原有工程目录的情况下，将已有工程迁移到STM32CubeIDE中。
8 w' ?! U/ q, z9 w
作者：bili_42806779649

3 b$ f/ f9 n+ H8 u
+ k: O. h# F9 l& ?8 \# R4 [4 g5 H5 Z