Yocto构建myapp时共享库依赖QA错误的原因及解决方法

核心问题分析 #

1. 共享库SONAME未正确设置
   你的mylib.bb中编译共享库时没有指定SONAME参数，导致生成的libmylib.so.0.1的SONAME是libmylib.so而非预期的libmylib.so.0。应用链接时用-lmylib是动态链接的标准用法，但最终二进制会依赖SONAME指定的库文件。而libmylib.so仅存在于mylib-dev包，主包mylib只包含libmylib.so.0和libmylib.so.0.1，所以QA检查会报错找不到libmylib.so()的提供者。

2. FILES配置错误
   你的FILES_${PN}错误包含了静态库libmylib.a，这个文件应该属于mylib-staticdev包，虽然当前包拆分已经自动把它放到了staticdev，但配置冲突可能引发潜在问题。

3. CMake变量名笔误
   CMake脚本中find_library(MYLIB_LIB mylib)定义的变量是MYLIB_LIB，但后续用了${MYLIB_LIBS}（多了一个S），这属于语法错误，可能导致链接时未正确引入库。

修复步骤 #

1. 修正mylib.bb的编译逻辑，添加SONAME参数

修改do_compile中的共享库编译命令，指定SONAME为libmylib.so.0：

do_compile() {
    ${CC} -c -o mylib.o ${S}/mylib.c
    # 添加SONAME参数，指定版本化的库名称
    ${CC} -shared -Wl,-soname,libmylib.so.0 -o libmylib.so mylib.o
    ${AR} rcs libmylib.a mylib.o
}

2. 修正mylib.bb的FILES配置

主包仅保留版本化的动态库，静态库交给staticdev包管理：

FILES_${PN} = "\
    ${libdir}/libmylib.so.0 \
    ${libdir}/libmylib.so.0.1 \
"
# 明确指定静态库归属，避免自动拆分异常
FILES_${PN}-staticdev = "${libdir}/libmylib.a"

3. 修正CMake脚本的变量名错误

将${MYLIB_LIBS}改为${MYLIB_LIB}，匹配find_library定义的变量：

find_library(MYLIB_LIB mylib)
...
target_link_libraries(
    myapp
    PRIVATE
        Qt5::Core
        ${MYLIB_LIB}
)

4. 重新编译验证

• 先清理并重新编译mylib：

  bitbake mylib -c cleanall && bitbake mylib
  

• 再编译myapp：

  bitbake myapp
  

此时应用的动态依赖会被正确记录为libmylib.so.0，而mylib包正好提供该文件，QA检查会通过。

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