此篇博客介绍如何使用 ESP-IDF 生成第三方的 .a 静态库并使用的流程,分为以下两个部分:
- 使用 ESP-IDF 生成第三方的 .a 静态库
- 通过 ESP-IDF 使用第三方的 .a 静态库
注:使用的 ESP-IDF 为 v4.3.1。
1 使用 ESP-IDF 生成第三方的 .a 静态库
此小节演示如何将 helloworld.c 制作成一个简单的 .a 静态库, 可以参考第三方示例 generate_static_library。
由于 ESP-IDF 也会默认在项目编译时将项目里 components 文件夹下的每个 component 输出成对应的 .a 库文件,在 build 文件夹下,所以我们仅需将 helloworld 做成一个 component。
helloworld 库 里的内容为需要做成 .a 库的代码结构。
此处为了简便, helloworld.c 里只有一个 API printf_hello_world。
void printf_hello_world(void)
{
printf("Hello world!\n");
}
编译 generate_static_library 示例,编译后在项目文件夹下的 build/esp-idf/hello_world 目录可以找到对应的 helloworld.a 。此文件即为生成的第三方 .a 静态库。如下:
2 使用 ESP-IDF 使用第三方的 .a 静态库
此小节演示如何使用上一小节生成的 hellowold.a 库文件。可参考示例 use_static_library。
查看示例 use_static_library可以看到将 helloworld.a 放在了创建在项目目录下的 components/helloworld 中,同时还需要放置对应的 .h 文件在 include 文件夹中来方便调用 .a 库里的 API。如下:
此时需要特别注意的是 components/helloworld 里 CMakeLists.txt 的写法,如下:
idf_component_register(INCLUDE_DIRS "./include")
target_link_libraries(${COMPONENT_LIB} INTERFACE "${CMAKE_CURRENT_LIST_DIR}/libhello_world.a")
target_link_libraries
用来链接对应的 helloworld.a 库文件。
然后在 main 函数 里调用 .a 库文件里的 API printf_hello_world()
,如下:
编译烧写此示例,可以看到输出 log 里显示成功调用了 printf_hello_world()
并打印 Hello world!
,如下:
此时则说明成功使用了第三方库 helloworld.a。