如何将预编译库添加到 ESP8266 SDK？

Question

我有一个预编译的库（.a 扩展名），我想在 ESP8266 RTOS SDK 示例中使用它。

在以下路径（ESP8266_RTOS_SDK\components\esp8266\lib）中有一个文件夹，里面有 22 个 .a 文件。我已经把我的库放在那里了，但是编译器就像它没有识别我的库的功能。

我已经阅读了一些关于编辑一些 makefile 的内容。我真的应该这样做吗？如果是，我想知道要编辑哪个文件？ （放置在哪个路径上）

编辑

这是我的工作文件夹：

我被 Espressif（ESP8266 的开发者）指导在 component.mk 上制作如下所示，但它不起作用，编译一直显示“未定义的引用”对于库的功能。

然后我在 Windows 上创建了一个名为 COMPONENT_PATH 的环境变量，其路径与第一张图片中显示的相同。

这有什么问题吗？

编辑 2

在 main: 中创建文件夹“include”：

在 C 代码之上添加：#include "include/lib123.h"，其中仅包含一行：int sum (int a, int b);

在 main 上添加了一个调用：int result = sum(1,2);

得到编译器错误：未定义对“sum”的引用

编辑 3

对于每次编译尝试，文件夹 \esp\tcp_server\build 中的以下文件都会更新。

这里就不直接放了，因为文件有10000多行：https://raw.githubusercontent.com/jefersonpehls/esp8266_freeRTOS_firebase/master/tcp_server.map

EDIT4

当我尝试制作时，显示的是这样的：

make
Toolchain path: /opt/xtensa-lx106-elf/bin/xtensa-lx106-elf-gcc
Toolchain version: crosstool-ng-1.22.0-100-ge567ec7b
Compiler version: 5.2.0
Python requirements from C:/msys32/home/sandr/esp/ESP8266_RTOS_SDK/requirements.txt are satisfied.
LD build/tcp_server.elf
C:/msys32/home/sandr/esp/tcp_server/build/main\libmain.a(tcp_server_v5.o):(.literal.app_main+0x24): undefined reference to `sum'
C:/msys32/home/sandr/esp/tcp_server/build/main\libmain.a(tcp_server_v5.o): In function `app_main':
C:/msys32/home/sandr/esp/tcp_server/main/tcp_server_v5.c:382: undefined reference to `sum'
collect2.exe: error: ld returned 1 exit status
make: *** [C:\msys32\home\sandr\esp\ESP8266_RTOS_SDK/make/project.mk:510: /home/sandr/esp/tcp_server/build/tcp_server.elf] Error 1

编辑 5

这是我用来制作的完整步骤

sandr@DESKTOP-MA6RTB6 MINGW32 ~
$ cd ~/esp/tcp_server

sandr@DESKTOP-MA6RTB6 MINGW32 ~/esp/tcp_server
$ export PATH="$PATH:/opt/xtensa-lx106-elf/bin"

sandr@DESKTOP-MA6RTB6 MINGW32 ~/esp/tcp_server
$ make
Toolchain path: /opt/xtensa-lx106-elf/bin/xtensa-lx106-elf-gcc
Toolchain version: crosstool-ng-1.22.0-100-ge567ec7b
Compiler version: 5.2.0
Python requirements from C:/msys32/home/sandr/esp/ESP8266_RTOS_SDK/requirements.txt are satisfied.
LD build/tcp_server.elf
C:/msys32/home/sandr/esp/tcp_server/build/main\libmain.a(tcp_server_v5.o):(.literal.app_main+0x24): undefined reference to `sum'
C:/msys32/home/sandr/esp/tcp_server/build/main\libmain.a(tcp_server_v5.o): In function `app_main':
C:/msys32/home/sandr/esp/tcp_server/main/tcp_server_v5.c:382: undefined reference to `sum'
collect2.exe: error: ld returned 1 exit status
make: *** [C:\msys32\home\sandr\esp\ESP8266_RTOS_SDK/make/project.mk:510: /home/sandr/esp/tcp_server/build/tcp_server.elf] Error 1

编辑 6

这是 esp\tcp_server\Makefile 的内容

#
# This is a project Makefile. It is assumed the directory this Makefile resides in is a
# project subdirectory.
#

PROJECT_NAME := tcp_server

EXTRA_COMPONENT_DIRS = $(IDF_PATH)/examples/common_components/protocol_examples_common


include $(IDF_PATH)/make/project.mk

这是esp\tcp_server\main\component.mk的内容

#
# "main" pseudo-component makefile.
#
# (Uses default behaviour of compiling all source files 
# in directory, adding 'include' to include path.)

COMPONENT_ADD_INCLUDEDIRS := include
COMPONENT_ADD_LDFLAGS += $(COMPONENT_PATH)/lib123.a

IDF_PATH 是 C:\msys32\home\sandr\esp\ESP8266_RTOS_SDK

编辑 7

这是 $(IDF_PATH)/make/project.mk

https://github.com/jefersonpehls/esp8266_freeRTOS_firebase/blob/master/project.mk

Answer 1

链接对象库代码是链接器而不是编译器的工作。

仅将库放在文件夹中是不够的，链接器需要知道库的路径和库名称。该文件不必与其他库位于同一文件夹中，尽管这样可以避免向链接器命令行添加额外的库路径。

如果使用 GNU 工具链，链接器 (ld) 使用 -L<searchdir> 开关注册库路径，对于名为 libXXX.a 的库，链接它的开关是 -lXXX。

例如：

ld -o program.elf main.o module.o -L.\MyLibraries -llinkthis.a

将链接 liblinkthis.a 在构建目录的 MyLibraries 子文件夹中。

如果使用gcc 或g++ 驱动程序编译和链接，这些开关可以传递给驱动程序并用于调用ld。例如：

gcc main.c -o main.o -c
gcc module.c -o module.o -c
gcc -L.\MyLibraries -llinkthis.a main.o module.o -o program.elf 

或者对于单个源构建：

gcc main.c -L.\MyLibraries -llinkthis.a -o program.elf

对于其他工具链，请参阅关于链接静态库的工具链/链接器文档。

对于包含许多模块的复杂构建，那么您当然应该使用 makefile 或类似的构建管理工具，或者（更容易）带有项目/构建管理器的 IDE。 IDE 可能允许您通过对话框添加库和路径，而不必知道工具链的所有单独开关，make 和类似工具对于复杂的构建可能更灵活，但有点神秘。但是使用make 与如何链接静态库的问题并没有直接关系。