使用CMake将OS抽象层接入静态库后库内符号未定义如何解决

问题原因 #

你观察到的liblib.a中lib_os_*符号未定义属于正常现象，和CMake配置错误无关：

• 静态库（.a格式）本质是多个目标文件（.o）的归档包，编译静态库阶段仅完成源码到机器码的编译，不会解析外部依赖的符号，所有外部调用的符号都会留到最终链接生成可执行文件的阶段统一处理。
• 你当前的CMake配置将lib_os_glue.c添加到了最终的app可执行目标中，最终链接时会同时加载liblib.a、main.o、lib_os_glue.o以及Zephyr内核库，所有符号都能正常解析，所以项目可以正常编译运行。

调整方案（根据实际需求选择） #

方案1：希望lib库自包含Zephyr适配层，上层应用无需额外处理适配代码 #

修改CMakeLists.txt，将适配层源码从app目标迁移到lib静态库目标即可：

# SPDX-License-Identifier: Apache-2.0

cmake_minimum_required(VERSION 3.20.0)

find_package(Zephyr REQUIRED HINTS $ENV{ZEPHYR_BASE})
project(hello_world)

target_sources(app PRIVATE src/main.c)

add_library(lib STATIC src/lib/lib.c)
# 新增：把适配层编译进静态库
target_sources(lib PRIVATE src/lib_os_glue.c)
target_include_directories(lib PUBLIC src/lib)
# 新增：让适配层能正常引用Zephyr内核头文件
target_link_libraries(lib PRIVATE zephyr_interface)

target_link_libraries(app PRIVATE lib)

调整后重新编译生成的liblib.a就会包含lib_os_msleep的实现，再用readelf查看就不会看到该符号未定义的记录。此时仅剩Zephyr内核接口（比如k_msleep）是未定义状态，属于正常情况，内核符号会在最终链接app时从Zephyr预编译库中解析。

方案2：希望lib库跨OS通用，支持对接不同操作系统的适配层 #

不需要修改任何配置，你当前的写法就是标准的跨OS静态库实现方案：

• 通用逻辑编译成liblib.a，所有OS相关调用通过glue层抽象
• 上层应用根据目标操作系统选择对应glue层的实现源码编译
• 最终链接时统一解析符号，不需要修改静态库本身就能适配Zephyr、Linux、FreeRTOS等不同系统

内容的提问来源于stack exchange，提问作者Kodiak