保姆级教程：在Ubuntu 20.04上为ARM开发板交叉编译GStreamer 1.14.0（含所有依赖库）

ARM嵌入式开发实战：Ubuntu 20.04下GStreamer 1.14.0全依赖链交叉编译指南

当我们需要在资源受限的ARM开发板上实现高效多媒体处理时，GStreamer往往是首选框架。但将其成功移植到嵌入式平台，需要穿越复杂的依赖迷宫。本文将手把手带你完成从零开始的完整编译之旅，特别针对树莓派、RK3399等常见ARM平台。

1. 环境准备与工具链配置

交叉编译的第一步是搭建合适的构建环境。不同于x86平台的直接编译，我们需要在Ubuntu 20.04主机上为目标ARM板准备全套工具链。

1.1 基础系统要求

确保你的Ubuntu系统已安装以下基础包：

sudo apt update && sudo apt install -y \ build-essential \ autoconf \ automake \ libtool \ pkg-config \ flex \ bison \ yasm \ cmake \ git \ wget

1.2 交叉编译器选择

根据目标板架构选择工具链：

• 树莓派3/4（Cortex-A53/A72）：gcc-arm-linux-gnueabihf
• RK3399（Cortex-A72/A53）：aarch64-linux-gnu-gcc

安装示例：

sudo apt install gcc-arm-linux-gnueabihf g++-arm-linux-gnueabihf

验证工具链：

arm-linux-gnueabihf-gcc --version

1.3 工作目录结构

建议采用清晰的目录组织：

~/gst-build/ ├── sources/ # 存放源码包 ├── prefix/ # 安装目录 │ ├── lib/ │ ├── include/ │ └── bin/ └── downloads/ # 下载缓存

2. 依赖库的逐层编译

GStreamer依赖链如同金字塔，必须按正确顺序构建。以下是经过验证的编译顺序及关键参数。

2.1 基础库编译

zlib压缩库：

cd zlib-1.2.11 CC=arm-linux-gnueabihf-gcc \ ./configure --prefix=$HOME/gst-build/prefix \ --shared make -j$(nproc) make install

libffi接口库：

cd libffi-3.2.1 ./configure --host=arm-linux-gnueabihf \ --prefix=$HOME/gst-build/prefix make -j$(nproc) make install

2.2 核心依赖构建

glib库编译技巧： 需要特别注意环境变量设置：

export LIBFFI_CFLAGS="-I$HOME/gst-build/prefix/include" export LIBFFI_LIBS="-lffi -L$HOME/gst-build/prefix/lib" export ZLIB_CFLAGS="-I$HOME/gst-build/prefix/include" export ZLIB_LIBS="-lz -L$HOME/gst-build/prefix/lib" cd glib-2.56.1 ./configure --host=arm-linux-gnueabihf \ --prefix=$HOME/gst-build/prefix \ --with-pcre=internal \ glib_cv_stack_grows=no \ ac_cv_func_posix_getpwuid_r=yes make -j$(nproc) make install

OpenSSL特殊处理：

cd openssl-1.1.1h ./Configure linux-armv4 \ --prefix=$HOME/gst-build/prefix \ no-asm shared \ -D__ARM_MAX_ARCH__=8 # 手动移除Makefile中的-m64标志 make -j$(nproc) make install

2.3 多媒体相关库

x264编码器配置：

cd x264-master ./configure --host=arm-linux-gnueabihf \ --prefix=$HOME/gst-build/prefix \ --enable-shared \ --disable-asm \ --cross-prefix=arm-linux-gnueabihf- make -j$(nproc) make install

ORC优化编译器：

cd orc-0.4.28 ./configure --host=arm-linux-gnueabihf \ --prefix=$HOME/gst-build/prefix make -j$(nproc) make install

3. GStreamer主体编译

当所有依赖就位后，终于可以编译主角了。

3.1 配置环境变量

设置关键路径变量：

export PKG_CONFIG_PATH=$HOME/gst-build/prefix/lib/pkgconfig export LD_LIBRARY_PATH=$HOME/gst-build/prefix/lib export PATH=$HOME/gst-build/prefix/bin:$PATH

3.2 编译参数详解

GStreamer的configure需要特殊处理：

cd gstreamer-1.14.0 ./configure --host=arm-linux-gnueabihf \ --prefix=$HOME/gst-build/prefix \ LDFLAGS="-Wl,--unresolved-symbols=ignore-in-shared-libs" \ --disable-loadsave \ --disable-gtk-doc \ --disable-valgrind \ ac_cv_func_register_printf_function=no

关键参数说明：

• --unresolved-symbols：允许动态链接时缺失符号
• disable-loadsave：禁用不必要的插件保存功能
• ac_cv_func：绕过特定函数检测

3.3 编译与验证

启动并行编译：

make -j$(nproc) make install

验证生成的库文件：

file $HOME/gst-build/prefix/lib/libgstreamer-1.0.so.0.1400.0

应显示"ARM aarch64"或类似架构信息。

4. 常见问题解决方案

4.1 链接错误处理

问题现象：undefined reference to...

解决方案：

1. 检查PKG_CONFIG_PATH是否包含所有依赖库的pkgconfig目录
2. 确认LD_LIBRARY_PATH设置正确
3. 使用-Wl,--verbose参数查看详细链接过程

4.2 架构不匹配

问题现象：Invalid ELF class或wrong ELF class

解决方法：

# 确认工具链与目标板匹配 readelf -h /path/to/library.so | grep Machine

4.3 性能优化技巧

编译时添加CFLAGS优化：

export CFLAGS="-O2 -mcpu=cortex-a53 -mfpu=neon-vfpv4 -mfloat-abi=hard"

对于特定开发板的优化：

• 树莓派4：-mcpu=cortex-a72 -mtune=cortex-a72
• RK3399：-march=armv8-a+crc+crypto

5. 部署与测试

5.1 文件系统打包

建议使用rsync同步到目标板：

rsync -avz --delete $HOME/gst-build/prefix/ user@target:/opt/gstreamer

5.2 环境变量配置

在目标板/etc/profile中添加：

export GST_PLUGIN_PATH=/opt/gstreamer/lib/gstreamer-1.0 export LD_LIBRARY_PATH=/opt/gstreamer/lib:$LD_LIBRARY_PATH

5.3 基础功能测试

运行简单管道测试：

gst-launch-1.0 videotestsrc ! autovideosink

如果遇到插件加载问题，检查：

GST_DEBUG=2 gst-inspect-1.0