嵌入式 Linux 与 RTOS / 系统课时
交叉编译并集成第三方库
交叉编译并集成第三方库
交叉编译第三方库最容易出错的不是编译器本身,而是头文件、.pc 文件和共享库来自错误的系统。本篇用 sysroot、pkg-config、CMake 与 Autotools 建立统一搜索边界,并给出识别主机库误链接、错误 RPATH 和运行时缺库的方法。
学习目标
- 用 sysroot 与 pkg-config 把头文件和库搜索限定在目标根文件系统。
- 为 CMake 与 Autotools 设置交叉编译边界,避免误用主机依赖。
- 通过 ELF 依赖与运行时路径检查定位共享库集成问题。
先锁定目标系统的搜索空间
交叉编译同时存在两个世界:构建主机负责运行编译工具,目标系统负责运行最终程序。编译器可以来自主机,但头文件、目标库和 pkg-config 元数据必须来自目标 sysroot。若把主机的 /usr/include 或 /usr/lib 混进来,往往会在链接阶段或上板后才暴露问题。

PKG_CONFIG_SYSROOT_DIR 会把 .pc 中以 /usr 等绝对前缀表示的路径重定位到 sysroot;PKG_CONFIG_LIBDIR 则替换 pkg-config 的默认搜索目录。交叉编译时通常应清空 PKG_CONFIG_PATH,避免它把主机安装的包重新带回来。
用 pkg-config 完成一次可验证的交叉链接
下面假设 SDK 已提供 AArch64 交叉编译器,sysroot 位于 <PATH>/sysroot,并且其中已经安装 zlib 的头文件、共享库和 zlib.pc。若 SDK 使用 multiarch 目录,应把 PKG_CONFIG_LIBDIR 改成目标 .pc 文件实际所在目录。
片段示例,保存为 main.c,它依赖后续交叉编译命令才能生成目标程序。
#include <stdio.h>
#include <zlib.h>
int main(void) {
puts(zlibVersion());
return 0;
}在同一目录执行下面的完整构建与检查命令:
export SYSROOT="<PATH>/sysroot"
export PKG_CONFIG_SYSROOT_DIR="$SYSROOT"
export PKG_CONFIG_LIBDIR="$SYSROOT/usr/lib/pkgconfig:$SYSROOT/usr/share/pkgconfig"
unset PKG_CONFIG_PATH
CC=aarch64-linux-gnu-gcc
CFLAGS="$(pkg-config --cflags zlib)"
LIBS="$(pkg-config --libs zlib)"
"$CC" --sysroot="$SYSROOT" main.c $CFLAGS $LIBS -o app
aarch64-linux-gnu-readelf -h app | grep 'Machine:'
aarch64-linux-gnu-readelf -d app | grep 'Shared library'预期输出如下;共享库顺序可能不同,但架构应为 AArch64,且依赖来自目标 ABI:
Machine: AArch64
Shared library: [libz.so.1]
Shared library: [libc.so.6]此时还没有证明目标机一定能运行程序,但已经证明产物不是主机 ELF,并且链接器记录的是目标侧共享库名。上板后若执行 app 能打印 zlib 版本号,就完成了编译期与运行期两侧验证。
让 CMake 与 Autotools 遵守同一边界
CMake 最稳妥的做法是使用 toolchain file,把编译器、sysroot 和查找模式集中定义。下面是片段示例,依赖项目自身的 CMakeLists.txt。
set(CMAKE_SYSTEM_NAME Linux)
set(CMAKE_SYSTEM_PROCESSOR aarch64)
set(CMAKE_C_COMPILER aarch64-linux-gnu-gcc)
set(CMAKE_SYSROOT "<PATH>/sysroot")
set(CMAKE_FIND_ROOT_PATH "<PATH>/sysroot")
set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER)
set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)
set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)
set(CMAKE_FIND_ROOT_PATH_MODE_PACKAGE ONLY)其中 PROGRAM NEVER 允许 CMake 在主机寻找构建期工具,而 LIBRARY、INCLUDE 和 PACKAGE 的 ONLY 则强制目标依赖从 sysroot 查找。若项目使用 pkg-config,还应在调用 CMake 前设置前一节的两个 pkg-config 环境变量。
Autotools 的判断标准相同:--build 表示运行构建工具的主机,--host 表示最终二进制运行的平台。交叉构建时必须让 CC、CFLAGS、LDFLAGS 和 pkg-config 指向目标工具链与 sysroot,而不是只传一个 --host 就结束。项目若提供 config.site,可以把这些环境约束集中维护,避免不同开发机各自拼接参数。
检查 RPATH 与运行时共享库
sysroot 只影响构建期,目标动态加载器并不知道主机上的 SDK 路径。因此绝不能把 <PATH>/sysroot/usr/lib 之类的主机绝对路径写进 RPATH 或 RUNPATH。对随应用一起部署的私有库,更适合使用相对于可执行文件的 $ORIGIN。
CMake 中可按部署布局设置运行时路径;下面是配置片段,不是独立项目。
set(CMAKE_INSTALL_RPATH "$ORIGIN/../lib")
set(CMAKE_BUILD_RPATH_USE_ORIGIN TRUE)检查产物时,用 readelf -d app 关注 NEEDED、RPATH 和 RUNPATH。如果目标机报 error while loading shared libraries,先确认缺失的 .so 是否真的被复制到根文件系统,再确认动态加载器搜索目录是否包含它;不要通过加入主机 SDK 的绝对路径来“修好”构建。
稳定的交叉编译链路应满足三件事:构建工具在主机运行、目标依赖全部来自 sysroot、运行时库只依赖目标文件系统中的可部署路径。只要这三条边界清晰,CMake、Autotools 和 pkg-config 就能共享同一套诊断方法。