目录一、问题现象二、根本原因2.1 硬件差异即使 CPU 相同2.2 软件差异2.3 编译环境差异三、为什么不能直接复制3.1 动态链接问题3.2 设备树问题3.3 路径问题四、解决方案4.1 方案对比4.2 方案1针对板子重新编译推荐4.3 方案2静态编译最通用4.4 方案3Docker 统一环境4.5 方案4从板子复制库五、最佳实践建议5.1 开发流程5.2 代码适配技巧5.3 Makefile 支持多板子六、核心要点总结七、你的情况总结八、静态库 vs 动态库完整知识总结8.1、两种库的本质区别8.1.1 定义对比8.1.2 工作原理九、静态库详解9.1 特点9.2 使用方式9.3 适用场景十、动态库详解10.1 特点10.2 使用方式10.3 运行时库搜索路径10.4 适用场景十一、版本兼容性问题你的核心问题11.1 为什么动态库换板子不能运行11.2 符号不兼容示例11.3 版本管理十二、静态库 vs 动态库选择指南12.1 选择静态库的情况12.2 选择动态库的情况十三、交叉编译中的库问题13.1 问题根源13.2 你的情况分析十四、解决方案对比14.1 三种方案14.2 方案详解方案1用板子 SDK 重新编译你正在做的方案2程序 .so 一起部署方案3静态编译十五、查看程序依赖的方法15.1 查看程序类型15.2 查看动态库依赖15.3 查看库的符号十六、你的项目建议16.1 当前情况16.2 建议做法16.3 如果想一次编译多处运行十七、核心要点总结十八、一句话总结一、问题现象易百纳板子编译的程序 → 易百纳板子 ✅ 正常运行易百纳板子编译的程序 → 荣品板子 ❌ 无法运行这不是程序写错了而是嵌入式开发中的普遍现象。二、根本原因2.1 硬件差异即使 CPU 相同差异点易百纳荣品影响摄像头接口/dev/video0/dev/video5程序打不开摄像头屏幕接口HDMIMIPI DSI显示无输出GPIO 引脚GPIO0_A0GPIO3_B1控制失效内存大小1GB2GB可能 OOM外设配置不同不同驱动不匹配2.2 软件差异差异点易百纳荣品影响内核版本4.194.19可能不同补丁API 不兼容rkmedia 版本v1.0v1.2符号不匹配系统类型BuildrootUbuntu库路径不同设备树yibaina.dtsrongpin.dts硬件描述不同2.3 编译环境差异差异点易百纳荣品SDK 来源易百纳官网荣品官网交叉编译工具链gcc 6.3gcc 8.3头文件路径易百纳 SDK荣品 SDK库文件版本易百纳编译荣品编译三、为什么不能直接复制3.1 动态链接问题程序易百纳编译↓ 依赖libeasymedia.so (易百纳版本 v1.0)↓ 调用librkmedia.so (易百纳版本 v1.0)在荣品板子上荣品系统有libeasymedia.so但版本是 v1.2函数接口可能变化符号可能不兼容运行时找不到需要的符号 → 崩溃3.2 设备树问题设备树告诉内核硬件如何配置易百纳设备树:camera0 {reg 0;pinctrl cam_pins_a;}荣品设备树:camera1 {reg 1;pinctrl cam_pins_b;}程序在易百纳上打开/dev/video0荣品上可能/dev/video5。3.3 路径问题系统库路径Buildroot/usr/libUbuntu/usr/lib/arm-linux-gnueabihf程序在 Buildroot 上编译时链接/usr/lib/librkmedia.so在 Ubuntu 上找不到。四、解决方案4.1 方案对比方案工作量可靠性通用性针对板子重新编译⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐静态编译⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐Docker 统一环境⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐从板子复制库⭐⭐⭐⭐⭐⭐⭐⭐4.2 方案1针对板子重新编译推荐# 易百纳板子cd /path/to/yibaina/sdk./build.sh lunch # 选易百纳版型make# 荣品板子cd /path/to/rongpin/sdk./build.sh lunch # 选荣品版型make优点最可靠保证兼容性缺点需要维护多套 SDK4.3 方案2静态编译最通用# 编译时静态链接所有库arm-linux-gnueabihf-g -static -o app app.c -lrkmedia -lrkaiq -lpthread优点不依赖板子上的动态库理论上任何 RV1126 板子都能运行不需要针对板子重新编译缺点文件很大几 MB → 几十 MB启动稍慢无法利用系统库更新4.4 方案3Docker 统一环境# 荣品提供的 Docker 镜像docker load -i rp-dev-docker-ubuntu2004.tar./run.shcd /home/SDK_DIR./build.sh优点环境一致可移植缺点还是需要针对板子配置版型4.5 方案4从板子复制库# 从荣品板子复制库scp rootrongpin:/usr/lib/librkmedia.so* ~/rongpin_libs/scp rootrongpin:/usr/include/rkmedia/* ~/rongpin_include/# 用这些库编译arm-linux-gnueabihf-g -I~/rongpin_include -L~/rongpin_libs app.c -lrkmedia优点不需要完整 SDK缺点可能缺头文件版本管理麻烦五、最佳实践建议5.1 开发流程┌─────────────────────────────────────────────────────┐ │ 维护一个代码仓库但针对每个板子单独编译 │ ├─────────────────────────────────────────────────────┤ │ │ │ 应用源码 (Git) │ │ ↓ │ │ ┌─────┴─────┐ │ │ ↓ ↓ │ │ 易百纳 荣品 │ │ 编译环境 编译环境 │ │ ↓ ↓ │ │ 易百纳 荣品 │ │ 可执行文件 可执行文件 │ │ ↓ ↓ │ │ 易百纳 荣品 │ │ 板子运行 板子运行 │ └─────────────────────────────────────────────────────┘5.2 代码适配技巧// 用宏区分不同板子 #ifdef BOARD_YIBAINA #define CAMERA_DEVICE /dev/video0 #define DISPLAY_TYPE HDMI #elif defined BOARD_RONGPIN #define CAMERA_DEVICE /dev/video5 #define DISPLAY_TYPE MIPI #endif // 运行时检测 const char* get_camera_device() { if (access(/dev/video5, F_OK) 0) return /dev/video5; return /dev/video0; }5.3 Makefile 支持多板子makefile# 选择板子 BOARD ? rongpin ifeq ($(BOARD), yibaina) SDK_ROOT : /home/user/sdk_yibaina CFLAGS -DBOARD_YIBAINA else SDK_ROOT : /home/user/sdk_rongpin CFLAGS -DBOARD_RONGPIN endif GCC : $(SDK_ROOT)/prebuilts/gcc/.../arm-linux-gnueabihf-g六、核心要点总结要点说明CPU 相同 ≠ 程序通用外设、设备树、库版本都不同每个板子需要自己的 SDK厂商提供的 SDK 针对自家板子优化重新编译是标准做法不是系统问题是开发流程的一部分代码可以复用用条件编译或运行时检测适配不同板子静态编译可通用但体积大适合小工具Docker 不能解决硬件差异只能统一编译环境不能统一硬件配置七、你的情况总结易百纳板子 荣品板子 ↓ ↓ 易百纳 SDK 荣品 SDK ↓ ↓ 编译程序 A ←─ 代码复用 ─→ 编译程序 A ↓ ↓ 在易百纳运行 ✅ 在荣品运行 ✅关键点你的程序代码可以复用但需要用荣品 SDK 重新编译设备树、库路径、硬件配置由 SDK 自动适配你现在正在编译荣品的 Buildroot完成后就能编译出荣品板子可运行的程序八、静态库 vs 动态库完整知识总结基于你从易百纳换到荣品 RV1126 开发板时遇到的库兼容性问题我帮你梳理了静态库和动态库的核心知识8.1、两种库的本质区别8.1.1 定义对比类型静态库动态库文件后缀.a(Linux) /.lib(Windows).so(Linux) /.dll(Windows)编译时机编译时嵌入程序运行时加载程序独立性✅ 独立不依赖外部文件❌ 依赖外部 .so 文件文件大小大库代码复制进程序小库代码单独存放内存占用每个程序独立占用多个程序共享一份8.1.2 工作原理静态库编译过程 ┌─────────────┐ ┌─────────────┐ ┌─────────────────┐ │ 程序源码 │ │ libxxx.a │ → │ 完整可执行文件 │ │ (app.c) │ │ (静态库) │ │ (包含库代码) │ └─────────────┘ └─────────────┘ └─────────────────┘ 动态库编译过程 ┌─────────────┐ ┌─────────────┐ ┌─────────────────┐ │ 程序源码 │ │ libxxx.so │ → │ 可执行文件 │ │ (app.c) │ │ (动态库) │ │ (记录依赖) │ └─────────────┘ └─────────────┘ └─────────────────┘ ↓运行时加载 .so九、静态库详解9.1 特点优点✅ 程序独立不需要外部库文件✅ 部署简单复制一个文件就行✅ 不会出现库版本冲突✅ 加载速度快不需要动态链接缺点❌ 文件体积大❌ 内存占用高每个程序独立占用❌ 库更新需要重新编译程序❌ 编译时间长9.2 使用方式# 编译静态库gcc -c -o util.o util.car rcs libutil.a util.o# 静态链接程序gcc -static -o app app.c -L. -lutil# 查看是否是静态链接file app# 输出: app: ELF 32-bit LSB executable, ARM, statically linked9.3 适用场景场景是否适合小型工具程序✅ 适合需要单文件部署✅ 适合库版本不稳定的项目✅ 适合多个程序共享同一库❌ 不适合频繁更新的库❌ 不适合十、动态库详解10.1 特点优点✅ 文件体积小✅ 内存共享多个程序共用一份✅ 库更新不影响程序版本兼容时✅ 开发调试方便缺点❌ 依赖外部 .so 文件❌ 部署需要同时复制 .so❌ 可能出现找不到库错误❌ 版本兼容性问题10.2 使用方式# 编译动态库gcc -fPIC -shared -o libutil.so util.c# 动态链接程序gcc -o app app.c -L. -lutil# 查看依赖ldd app# 输出: libutil.so ./libutil.so10.3 运行时库搜索路径1. LD_LIBRARY_PATH 环境变量2. /etc/ld.so.conf 配置文件3. /lib4. /usr/lib5. /usr/local/lib10.4 适用场景场景是否适合大型项目✅ 适合多个程序共享库✅ 适合库频繁更新✅ 适合版本兼容需要单文件部署❌ 不适合十一、版本兼容性问题你的核心问题11.1 为什么动态库换板子不能运行易百纳编译的程序↓ 依赖librkmedia.so (易百纳版本 v1.0)↓ 运行时荣品板子上的 librkmedia.so (荣品版本 v1.2)↓函数接口可能变化 → 找不到符号 → 程序崩溃11.2 符号不兼容示例// 易百纳 librkmedia.so v1.0 提供的接口int rkmedia_init(int mode); // 旧接口// 荣品 librkmedia.so v1.2 提供的接口int rkmedia_init(int mode, char* cfg); // 新接口参数变化程序调用旧接口新库没有 → 运行时错误。11.3 版本管理库版本特点libxxx.so.1.0主版本号不兼容更新libxxx.so.1.1次版本号兼容更新libxxx.so.2.0主版本变化不兼容十二、静态库 vs 动态库选择指南12.1 选择静态库的情况✅ 程序需要单文件部署✅ 目标系统库版本不确定✅ 程序体积不是主要考虑✅ 不频繁更新库12.2 选择动态库的情况✅ 多个程序共享同一库✅ 库体积大需要节省空间✅ 库频繁更新✅ 系统已预装该库十三、交叉编译中的库问题13.1 问题根源电脑x86 开发板ARM↓ ↓编译环境 运行环境↓ ↓Buildroot 库 开发板系统库↓ ↓版本、路径可能不一致13.2 你的情况分析项目易百纳荣品编译环境易百纳 SDK荣品 SDK动态库易百纳编译的 .so荣品编译的 .so系统BuildrootUbuntu库路径/usr/lib/usr/lib/arm-linux-gnueabihf程序不能运行的原因易百纳编译的程序依赖易百纳的.so荣品板子上是荣品的.so库版本、符号、路径都不匹配十四、解决方案对比14.1 三种方案方案原理适用场景工作量动态链接板子专用用板子 SDK 的 .so 编译只针对一个板子⭐⭐动态链接通用程序 .so 一起部署多个板子带库部署⭐⭐⭐静态链接所有库嵌入程序任何板子都能运行⭐14.2 方案详解方案1用板子 SDK 重新编译你正在做的# 用荣品 SDK 编译cd /path/to/rongpin/sdk./build.sh lunch # 选荣品版型make✅ 最可靠⚠️ 每个板子需要单独编译方案2程序 .so 一起部署# 把程序和依赖的 .so 一起复制到板子scp app rootboard:/root/scp /path/to/librkmedia.so rootboard:/root/# 运行时指定库路径export LD_LIBRARY_PATH/root:$LD_LIBRARY_PATH./app✅ 程序只编译一次⚠️ 需要确保库兼容方案3静态编译arm-linux-gnueabihf-g -static -o app app.c -lrkmedia -lrkaiq✅ 任何 RV1126 板子都能运行❌ 文件很大可能 20-50 MB❌ 编译时间较长十五、查看程序依赖的方法15.1 查看程序类型file app# 动态链接: ELF 32-bit LSB executable, ARM, dynamically linked# 静态链接: ELF 32-bit LSB executable, ARM, statically linked15.2 查看动态库依赖# 在电脑上查看交叉编译的程序arm-linux-gnueabihf-readelf -d app | grep NEEDED# 在开发板上查看ldd app15.3 查看库的符号# 查看动态库提供的函数nm -D librkmedia.so | grep rkmedia_initreadelf -s librkmedia.so | grep rkmedia_init十六、你的项目建议16.1 当前情况你用的是动态库.so易百纳编译的程序在荣品上不能运行现在正在编译荣品的 Buildroot16.2 建议做法# 1. 完成荣品 Buildroot 编译cd ~/rv1126/SDK_DIR/rv1126-rv1109-linux./build.sh buildroot# 2. 用荣品的库编译你的应用cd ~/project/test# 修改 Makefile 使用荣品的工具链和库make# 3. 部署到荣品板子scp app root板子IP:/root/scp /path/to/librkmedia.so root板子IP:/usr/lib/16.3 如果想一次编译多处运行# 静态编译make CFLAGS-static十七、核心要点总结要点说明静态库(.a)编译时嵌入程序独立体积大动态库(.so)运行时加载依赖外部文件体积小换板子不能运行动态库版本、符号不兼容解决方案重新编译 或 静态链接你之前用的是动态库.so现在应该做用荣品 SDK 重新编译或用静态编译十八、一句话总结换板子程序不能运行是因为动态库不兼容。静态编译可以让程序在任何板子上运行但体积大用新板子的 SDK 重新编译是标准做法保证兼容性。