1. 前言
0 \: `4 k# Q! G在嵌入式开发中，经常有需要调用第三方库的需求，甚至需要制作自己的静态库。那么如何基于 STM32CubeIDE 来实现呢？本 LAT 以STM32G070的 Nucelo 开发板为例，介绍如何创建一个静态库以及实现调用它的过程。

* B8 B$ U0 q8 s- \2. 生成静态库
0 r$ s, I9 n" Q( x使用 STM32CubeIDE 可以很轻松的生成一个静态库，只需要将想要打包成库的源文件（.c 文件）和头文件（.h 文件）整理好，这些文件应包含你希望在其他项目中复用的功能代码，例如自定义的驱动程序、算法函数等。

- w& i& D: r/ \7 n# ^
7 t" b9 f  M3 |% R首先，打开 STM32CubeIDE，选择 “File->New->STM32 Project“，按照提示选择目标芯片，如下图所示。
, \: }; y* I5 O# L$ I% U, S

图1. 静态库工程的目标芯片选择

. Y9 D* m3 E/ p; n: k) L; @
在设置工程的界面中，按照如下图所示，配置生成静态库的工程。
5 B$ z) i. P5 v! R2 e5 i

图2. 新建静态库的工程

4 Q3 N# @" V% E: @
- p: O, U7 }- E& Q0 a然后在创建的静态库的工程中，创建头文件（.h 文件），如下图所示。
9 }! V9 e" f2 e* {9 _- o
1 K1 @/ i. e/ t
在 Inc 文件夹下创建“Lib.h”头文件：

图3. 创建头文件

图4. 创建头文件

STM32CubeIDE 在生成项目的时候，已经生成了一个 libLib.C 文件，在 libLib.c 源文件中，修改这个 myFunction 函数为你需要实现的功能或者添加更多应用，这里实现了一个计算数值平方的函数，并在 Lib.h 中进行了申明，具体代码如下图所示：
  C+ i! l( y# J& n) u

图5. Lib.c 源文件代码

图6. Lib.h 头文件代码

  [0 U7 A3 Y4 P& O当然如果觉得需要，还可以做一些优化操作，比如编译库的时候除去调试信息，可以在工程的属性中（鼠标点击工程名，右击选择“Properties”）添加“-g0”的编译命令，如下图所示：
( ~, _/ w: T9 a+ j; ]

图7. 去除静态库的调试信息

: e& J, V8 I, ^( H/ ^
/ d/ v8 Y$ Q, W8 I; ^% |& S至此，只需要编译工程即可，然后就可以在静态库工程的“Debug”目录下查看到生成的库文件了：
/ r3 |0 [2 f, o$ W7 H8 c

图8. 生成的库文件

这里需要注意，在生成库的时候，STM32CubeIDE 会自动添加“lib”的前缀到输出的库文件名之前，并且默认 STM32CubeIDE 输出的库文件的格式为“.a”的文件，所以工程名为“Lib”，输出的静态库文件名为“libLib.a”。当然如果你不喜欢这个名字，你可以进行修改。

/ ], T4 B& V$ P: w
% Z5 ^7 T, ^1 ~/ B3. 添加静态库
现在已经有静态库了，下面是如何将库添加到应用工程中来调用。
; `; c# I( \# B" h

这里依然是打开 STM32CubeIDE，选择 “File->New->STM32 Project“，生成一个名为“APP“的 STM32G070 的基础工程。这步操作仅是创建一个可以成功编译的工程即可。

图9. APP 应用工程配置

图10. APP 应用工程的目标芯片选择

0 H6 }, M/ D9 h& h$ L$ a然后将生成的静态库“libLib.a“ 复制到 APP 应用工程的“Core/Src”文件夹下，将静态库的头文件“Lib.h“复制到“Core/Inc”文件夹下。
7 r6 @, E. c3 H9 }4 |0 Z
3 Z/ r, A" E% {. {+ u1 R1 I
7 o5 D7 E2 j5 n/ H& }还需要分别添加静态库和静态库的路径到工程中，如下所示：

图11. 添加静态库到应用工程中

; r0 d" s# k8 `& ~) ?
9 ?( |% h% x, I, {注意：添加静态库时，比如静态库的名称为“libLib.a”，那么添加时的格式为“:libLib.a”。
4 `2 ^8 q# x3 }# i

图12. 添加静态库的路径到应用工程中

* t4 }* w# @! |* \9 L+ k6 g
好了，现在可以在应用工程中调用静态库里的函数啦。
8 D& h" p5 i" j/ W1 v
4 z6 \2 Q4 m3 Y2 `, P, H
如下图所示，在应用工程的主函数中有两个数组，初始化的时候都为 0，通过 num 数组元素通过赋值，ret 数组元素通过调用库函数来计算。
5 R2 j( y  v3 f# `

图13. 引用静态库

图14. 静态库调用测试

; z, V# _) {* N6 n  r通过仿真调试，可以看到的测试结果，如下图所示：

图15. 静态库测试结果

+ v3 K9 o$ J3 N/ Y
可以看到 ret 的数组中的元素，均为 num 数组中对应元素的平方数了，说明成功地调用了静态库中的函数了。
1 R& I0 s& `7 B0 S
% _7 V) ^5 j1 l: c
" R1 o# u0 o- P4. 小结
0 \4 r0 M4 f; E/ n3 f1 P好了，上述就是如何生成静态库和如何调用静态库的示例，希望对大家所帮助。
————————————————
+ Y* p. q! n+ @, X
2 h1 S6 h+ x; @" H, `8 d