1. 为什么要为 RISC-V 交叉编译 FFmpeg先交代一下背景。手头有一块 RISC-V 开发板装了 Linux想在上面做视频处理但板子的性能和存储空间都有限。直接用板子编译 FFmpeg 不是不行只是整个过程会让人崩溃源码体积大、编译耗时长、期间还要处理各种依赖搞不好编译到一半存储就满了。更现实的问题是FFmpeg 这种项目一旦需要调整配置、增减功能模块每次都要在慢速硬件上重新跑一遍完整构建迭代效率非常低。交叉编译刚好解决这个矛盾。所谓交叉编译就是在 x86_64 的 Fedora 工作站上用一套针对 RISC-V 架构的编译工具链生成可以在 RISC-V Linux 系统上直接运行的可执行文件。整个过程和普通本地编译的体验几乎一样改 configure 参数、make、make install但产物是目标架构的二进制。RISC-V 本身是一个开放指令集架构最近几年普及速度很快从高性能服务器到嵌入式 MCU 都能看到它的身影。Fedora 官方也维护了 RISC-V 的移植版本还有对应的交叉编译工具链包这让整件事在 Fedora 上做起来比在其它发行版上顺手不少。本文记录的就是一次完整实践从装工具链、拉源码、调 configure 参数到最终拿到一个能在 RISC-V 板上跑起来的 ffmpeg 二进制以及过程中踩过的各种坑。适合参考这篇内容的人想在 RISC-V 板卡上跑媒体处理任务、手头只有 x86 主机的开发者对交叉编译流程不熟、想拿一个真实项目练手的 Linux 用户以及需要在 CI 里批量产出 RISC-V 二进制的同学。如果你只是想在 x86 电脑上装个 FFmpeg 用那dnf install ffmpeg就够了本文的场景对不上。2. 准备工作Fedora 宿主机环境与 RISC-V 交叉工具链选型2.1 安装交叉编译工具链Fedora 的软件仓库里直接提供了 RISC-V 交叉编译工具链包名比 Debian/Ubuntu 那边好记一些。核心包是这几个sudo dnf install gcc-riscv64-linux-gnu gcc-c-riscv64-linux-gnu binutils-riscv64-linux-gnu如果想知道仓库里还有哪些 RISC-V 相关包可以直接搜dnf search riscv64搜出来的结果里还会有 glibc 的交叉版本、gdb 的交叉版本等等。结合 FFmpeg 构建需要我实际装的是sudo dnf install make git diffutils pkgconf \ gcc-riscv64-linux-gnu gcc-c-riscv64-linux-gnu \ binutils-riscv64-linux-gnu glibc-devel-riscv64-linux-gnu注意glibc-devel-riscv64-linux-gnu这个包它提供了目标系统的 C 库头文件和链接需要的 crt 文件。如果缺了这个后面 configure 阶段会出现找不到标准头文件的报错。安装完成后先验证一下工具链是否可用riscv64-linux-gnu-gcc -v能看到版本信息就说明基本没装错。再写个最小测试程序交叉编译后确认产物int main() { return 0; }riscv64-linux-gnu-gcc test.c -o test file test正常情况下输出会包含类似ELF 64-bit LSB executable, UCB RISC-V, RVC, double-float ABI的字样。到这里工具链就算跑通了。2.2 工具链版本与目标架构的匹配问题RISC-V 指令集发展很快工具链版本直接影响目标板子的兼容性。Fedora 仓库里的交叉工具链通常比较新如果你用的板子内核比较旧、或者板子的 SoC 只实现了基础整数指令集加乘除扩展RV64IMAC新工具链默认生成的目标文件可能在旧内核上加载失败报unknown reloc之类的链接错误。Fedora 仓库的 riscv64 工具链默认目标一般是 RV64GC也就是包含基础指令集、乘除、原子操作、单双精度浮点和压缩指令的完整组合。现在市面上主流的 RISC-V Linux 板子基本都支持 RV64GC所以直接用仓库自带的包问题不大。如果用的是很老的板子建议先查一下板子的 CPU 支持哪些指令集扩展再决定是否需要自己构建一套旧版本工具链。另外一个容易忽略的点是 ABI 风格。RISC-V Linux 下常见的 ABI 是 lp64d也就是 LP64 数据模型加双精度浮点调用约定。Fedora 的交叉包默认就是 lp64d如果板子浮点单元精度不够可能需要改成 lp64 或者 ilp32d这就得自己配置编译器的 multilib 了操作复杂度会上升不少。正常情况下直接默认就行但心里要有这根弦遇到文件加载类报错时先怀疑指令集和 ABI 不匹配。3. 拉取 FFmpeg 源码与 configure 策略3.1 源码获取与版本选择FFmpeg 官方推荐从 Git 仓库拉取源码这样能随时拿到最新特性。但如果追求稳定建议选发布版 tag。我这次用的是 n6.1 系列属于发布有一段时间的稳定版本新老特性平衡得比较好网上能搜到的资料也多。git clone https://git.ffmpeg.org/ffmpeg.git ffmpeg cd ffmpeg git checkout n6.1如果网络条件一般也可以去 ffmpeg.org 下载 release 源码包。Git 方式和压缩包方式对后续 configure 没有本质区别。源码拉下来之后先看一眼顶层目录里的 README 和 Changelog稍微了解当前版本包含什么特性。接下来最重要的步骤是运行 configure这一步会生成编译所需的 Makefile 和 config.h。交叉编译的 configure 参数能不能写对直接决定后面构建顺不顺利。3.2 configure 参数逐项拆解先给一份我实际使用的 configure 命令后面逐项解释./configure \ --archriscv64 \ --target-oslinux \ --enable-cross-compile \ --cross-prefixriscv64-linux-gnu- \ --prefix/opt/riscv-ffmpeg \ --disable-x86asm \ --disable-doc \ --disable-debug \ --disable-ffplay \ --enable-ffprobe \ --enable-small逐项说明--archriscv64告诉构建系统目标 CPU 架构是 RISC-V 64 位。这个参数会影响架构相关源码的选择比如一些与 CPU 特性有关的优化代码路径。--target-oslinux目标操作系统是 Linux。FFmpeg 支持的 OS 非常多从 Windows 到 Android 都有必须明确指定因为不同 OS 的进程调度接口、线程实现方式都有差异。--enable-cross-compile启用交叉编译模式。这是最关键的一个开关没有它FFmpeg 会默认你在为本机编译然后用宿主机的编译器去测各种特性大概率直接编译失败或者生成错误架构的二进制。--cross-prefixriscv64-linux-gnu-指定交叉编译工具链前缀。FFmpeg 会在这个前缀后面拼 gcc、ar、ranlib、strip 等工具名自动完成编译器、汇编器、链接器的选择和调用。相当于一次配置后面不再需要手动改 CC、AR 这些环境变量。--prefix/opt/riscv-ffmpeg指定安装路径。交叉编译的产物不要装到宿主机系统目录里否则会污染本机环境也容易和系统自带的 FFmpeg 冲突。装到一个独立目录后面拷到板子上也方便。--disable-x86asm禁止 x86 汇编优化。默认情况下 FFmpeg 会检测并使用 nasm/yasm 来加速 x86 平台的一些 hot path。RISC-V 平台用不上这些不关掉的话 configure 会报找不到汇编器或者直接识别异常。--disable-doc不生成文档减少构建时间。--disable-debug不包含调试符号产物体积更小。--disable-ffplayffplay 依赖 SDL 库交叉编译 SDL 又得多折腾一轮。不需要播放器功能的话直接关掉。--enable-ffprobe保留 ffprobe 工具这工具在调试媒体问题时太常用了建议留着。--enable-small优化产物体积代价是性能略有下降。对开发板场景来说存储和内存都紧张这个参数通常值得开。这些参数加到一起configure 就能在宿主机上生成一套目标架构为 RISC-V 的构建配置后续 make 命令直接使用这套配置完成编译链接中间不需要再手动指定工具链。3.3 外部库的取舍策略FFmpeg 功能强大很大程度上是因为它可以链接外部库比如 x264、x265、libvpx、libmp3lame 等等。但交叉编译环境下每个外部库都要单独为 RISC-V 目标架构编译一份这会把工作量扩大好几倍还可能引入一堆工具链兼容性问题。我的建议是分两步走。第一步先做一个不依赖任何外部库的最小版本把 FFmpeg 自带的编解码器跑通比如 H.264 解码走 FFmpeg 内置的 decoderAAC 也走内置实现。这个最小版本能正常工作了再评估要不要加外部库。如果确实需要 H.264 编码最简单的路径是交叉编译 x264。x264 依赖很少交叉编译配置相对简单git clone https://code.videolan.org/videolan/x264.git cd x264 ./configure --cross-prefixriscv64-linux-gnu- --hostriscv64-linux-gnu \ --disable-cli --enable-static make -j$(nproc)编译完成后把生成的 x264.h、x264_config.h 放到 sysroot 的 include 目录把 libx264.a 放到 sysroot 的 lib 目录再回到 FFmpeg 源码目录在 configure 命令末尾加上--enable-libx264 --enable-gpl。这里必须加--enable-gpl因为 x264 采用 GPL 许可证。但作为第一次交叉编译建议先不要加外部库。原因很简单外部库会引入大量 pkg-config 依赖和头文件依赖任何一个环节版本不匹配都会让报错内容变得极其难查。先把最小版本构建成功拿到成就感之后再逐个扩展体验会好很多。4. 完整编译流程与生成物处理4.1 执行 configure 并检查输出在 FFmpeg 源码目录里运行上一节给出的 configure 命令。正常结束时输出末尾会有一段配置摘要包含当前版本、支持的编解码器、可用的协议、外部库链接状态等信息。重点检查两处第一External libraries部分。如果没有启用额外库这里应该只有zlib之类的基础库且状态是yes。如果出现某些库是unknown或者no但你的需求里确实需要它那就得回到依赖环节检查。第二Architecture部分。确认显示riscv64而不是默认的x86_64。这个信息是 configure 根据--arch参数生成并写入配置的出现异常时会直接影响后续编译目录结构。configure 通过后执行make -j$(nproc)这里的$(nproc)会把宿主机全部 CPU 核心都用上。交叉编译时大部分编译工作是宿主机完成的目标板硬件规格反而不影响编译时间这也是交叉编译的另一个核心优势。编译过程可能持续几分钟到十几分钟不等取决于宿主机性能和启用的组件数量。编译日志里如果出现 error先别急着改代码绝大多数报错都跟工具链配置或者依赖缺失有关直接看错误提示对应的文件和行号再到第五节对应找解决方案。4.2 编译产物检查编译完成后在源码目录执行./ffmpeg -version这个命令有一个坑当前目录下的ffmpeg文件是刚刚生成的 RISC-V 二进制你在 x86 Fedora 宿主机上直接运行它shell 会尝试执行这个文件但系统无法识别 RISC-V 格式会报Exec format error。正确的验证方式是用file命令检查产物格式file ffmpeg输出里能看到类似这样的内容ELF 64-bit LSB executable, UCB RISC-V, version 1 (SYSV), statically linked, stripped当排除了动态链接、确认是 RISC-V 架构之后产物就能往目标板上放了。也可以先在本机试试用 QEMU 用户态运行sudo dnf install qemu-user-static qemu-riscv64 ./ffmpeg -version这样不用启动完整虚拟机系统就能直接在 x86 主机上执行 RISC-V 二进制。虽然速度比原生慢很多但验证基本功能够用。4.3 安装到独立目录与部署到开发板执行make install因为 configure 指定了--prefix/opt/riscv-ffmpeg所有产物会整齐地安装到/opt/riscv-ffmpeg/下面里面有bin、lib、include、share等目录。这个目录不会干扰宿主系统。把整个目录打包拷到目标板tar czf riscv-ffmpeg.tar.gz /opt/riscv-ffmpeg传到板子上之后解压如果产物是动态链接版本还需要保证板子上的动态链接器能找到 FFmpeg 依赖的共享库。最简单的办法是把/opt/riscv-ffmpeg/lib加进板子系统的库搜索路径或者在编译时直接make install到板子系统的/usr/local目录。如果希望产物完全不依赖目标板的库环境可以在 configure 时启用静态链接--disable-shared --enable-static静态链接的 ffmpeg 体积会大一些但部署时省心很多适合开发板这类环境容易被折腾的场景。我最后实际用的是半静态方案只静态链接了外部依赖库FFmpeg 自身组件仍然动态加载这样能在灵活性和依赖管理之间取得平衡。5. 常见问题排查与避坑记录5.1 运行时执行格式错误最常见的报错就是在 x86 宿主机上直接去跑交叉编译出来的二进制系统直接给一句cannot execute binary file或者Exec format error然后人就慌了以为自己编译错了。其实这是交叉编译的正常现象x86 内核不认识 RISC-V 的 ELF 格式。验证产物用file想要在宿主机里跑就用 qemu-user别去怀疑工具链坏了。5.2 configure 阶段找不到标准头文件报错内容一般是checking for x264... no ERROR: libx264 not found或者编译时出现fatal error: stdio.h: No such file or directory这是 sysroot 不完整导致的。交叉编译需要目标架构的 C 库头文件Fedora 上对应包是glibc-devel-riscv64-linux-gnu。如果装的是旧的工具链包可能有部分头文件没有配套跟上执行一次全量升级sudo dnf upgrade --refresh再看一下riscv64-linux-gnu-gcc编译测试文件能否通过如果测试文件能过说明 sysroot 基本完善只有 FFmpeg 报头文件缺失那就是某个特定依赖库的头文件问题需要查具体是哪一个。5.3 链接时出现 Relocation 错误编译到了链接阶段报错类似relocation R_RISCV_HI20 cannot be used against symbol xxx这通常是目标文件里混合了 RV32 和 RV64 的代码或者汇编代码与链接器版本不匹配。最常见的原因是工具链太新、FFmpeg 版本太旧或者反过来。解决办法有两种升级 FFmpeg 源码到最新 release或者回退工具链版本。从实际体验看升级 FFmpeg 源码比降级工具链更省事毕竟 FFmpeg 对 RISC-V 的支持一直在往前走老版本的问题在新版里基本都会被修掉。还有一种情况是启用了某个外部库该库用旧版汇编器编译生成的目标文件带有旧式 relocation新链接器不兼容。遇到这种就重点排查引入的外部库确认它们也是用同一套工具链、同一个 sysroot 编译出来的。5.4 pkg-config 路径混乱导致选错依赖交叉编译时pkg-config 默认会在宿主机系统目录里找.pc文件这就非常危险。假设你宿主机装了 libvpxpkg-config 找到了宿主机的 vpx.pc于是 FFmpeg 的 configure 报告找到了 libvpx但编译时用的却是 x86 的库文件最终链接报错或者生成畸形二进制。规避方法是给 configure 传递明确的 pkg-config 环境变量让它只搜索交叉编译环境的目录export PKG_CONFIG_LIBDIR/opt/riscv-sysroot/usr/lib/pkgconfig export PKG_CONFIG_PATH/opt/riscv-sysroot/usr/share/pkgconfigPKG_CONFIG_LIBDIR和PKG_CONFIG_PATH两个变量配合可以完全屏蔽宿主机 pkg-config 目录。注意设置完以后要重新运行 configure只改环境变量不重新 configure 是没有效果的FFmpeg 的配置结果已经固化在config.mak里了。5.5 使用 Fedora 平台特有包的小提示Fedora 的交叉工具链包版本和 Fedora 系统版本严格绑定。比如 Fedora 40 装的 gcc 交叉包和 Fedora 39 的工具链版本不同如果拿到旧版 Fedora 上编译产物去新版 Fedora 上做二次编译可能会因为系统库版本升级出现兼容性报错。这类问题没有通用解法最干净的做法是把构建过程固定在某个 Fedora 版本上用容器或者虚拟机保持环境一致。对我来说最常用的方案是写一个构建脚本把工具链安装、依赖检查、configure、make 全部串起来每次换新机器、新 Fedora 版本都能一键复现。这也是交叉编译项目里最值得投入的一环单次编译成功不算成功能重复构建才算。6. 针对不同 RISC-V 板卡的小规模构建经验补充如果目标板子的 CPU 不支持某些指令集扩展FFmpeg 在运行时可能会非法退出。可以在 configure 里针对特定 CPU 做优化--cpuriscv64更细致的调优可以用-mcpu参数传入 CFLAGS但这需要清楚了解目标 CPU 的微架构一般用户不建议乱加加错反而会导致运行时崩溃。另一个技巧是裁剪 FFmpeg 组件。开发板场景下通常只需要解码不需要编码或者只需要特定格式的封装解封装。可以在 configure 时加上--disable-encoders \ --disable-muxers \ --enable-demuxers \ --enable-parsers这样编译出的二进制体积能大幅缩小很多不必要的模块就不会被打包进去。我实际编译时还加过--disable-network如果板子上的应用不需要网络功能这个参数能再去掉一堆协议模块。裁剪前先想清楚应用需要什么裁剪后如果功能有缺失再回头打开对应模块重新编译。编译一次成本不高反复试几轮就知道自己的最小集是什么了。还有一点值得提的是FFmpeg 7.0 之后优化了 RISC-V 向量扩展支持如果你的板子 CPU 支持 V 扩展升级到新版本 FFmpeg 能享受到明显的性能提升。判断方法是在目标板上执行grep riscv /proc/cpuinfo如果能搜到rv64imafdcv或者更长的字符串说明 CPU 包含向量扩展值得用新版 FFmpeg 配合--extra-cflags-marchrv64gcv重新编译一次。7. 写在最后一次实践后的经验整理整个流程走下来最强烈的感受就是交叉编译本身不复杂复杂的是搞清楚“目标环境需要什么”再决定“宿主机上怎么配置”。工具链只负责把代码变成目标架构的二进制真正的核心决策都在 configure 这一步架构选什么、外部库要不要、裁剪到什么程度这些决策直接决定板子上的最终体验。如果你第一次做这件事我的建议是先放弃任何外部库和花哨优化把目标设为“能在 RISC-V 板子上跑通ffmpeg -version”。这一步走通了后面再考虑 x264、考虑汇编优化、考虑交叉编译 rust/cgo 程序都是水到渠成的事。反过来一上来就想一步到位编译出功能最全的版本很容易被各种依赖问题劝退。Fedora 做交叉编译宿主确实比很多发行版省心一套 dnf 命令就能把工具链装齐。以后有这类 RISC-V 媒体处理需求我不会再考虑把源码直接拷到板子上慢慢磨直接在 x86 机上跑一下交叉编译几分钟后拿成品走人这才是把工作站算力用在刀刃上的做法。
1. 为什么要为 RISC-V 交叉编译 FFmpeg先交代一下背景。手头有一块 RISC-V 开发板装了 Linux想在上面做视频处理但板子的性能和存储空间都有限。直接用板子编译 FFmpeg 不是不行只是整个过程会让人崩溃源码体积大、编译耗时长、期间还要处理各种依赖搞不好编译到一半存储就满了。更现实的问题是FFmpeg 这种项目一旦需要调整配置、增减功能模块每次都要在慢速硬件上重新跑一遍完整构建迭代效率非常低。交叉编译刚好解决这个矛盾。所谓交叉编译就是在 x86_64 的 Fedora 工作站上用一套针对 RISC-V 架构的编译工具链生成可以在 RISC-V Linux 系统上直接运行的可执行文件。整个过程和普通本地编译的体验几乎一样改 configure 参数、make、make install但产物是目标架构的二进制。RISC-V 本身是一个开放指令集架构最近几年普及速度很快从高性能服务器到嵌入式 MCU 都能看到它的身影。Fedora 官方也维护了 RISC-V 的移植版本还有对应的交叉编译工具链包这让整件事在 Fedora 上做起来比在其它发行版上顺手不少。本文记录的就是一次完整实践从装工具链、拉源码、调 configure 参数到最终拿到一个能在 RISC-V 板上跑起来的 ffmpeg 二进制以及过程中踩过的各种坑。适合参考这篇内容的人想在 RISC-V 板卡上跑媒体处理任务、手头只有 x86 主机的开发者对交叉编译流程不熟、想拿一个真实项目练手的 Linux 用户以及需要在 CI 里批量产出 RISC-V 二进制的同学。如果你只是想在 x86 电脑上装个 FFmpeg 用那dnf install ffmpeg就够了本文的场景对不上。2. 准备工作Fedora 宿主机环境与 RISC-V 交叉工具链选型2.1 安装交叉编译工具链Fedora 的软件仓库里直接提供了 RISC-V 交叉编译工具链包名比 Debian/Ubuntu 那边好记一些。核心包是这几个sudo dnf install gcc-riscv64-linux-gnu gcc-c-riscv64-linux-gnu binutils-riscv64-linux-gnu如果想知道仓库里还有哪些 RISC-V 相关包可以直接搜dnf search riscv64搜出来的结果里还会有 glibc 的交叉版本、gdb 的交叉版本等等。结合 FFmpeg 构建需要我实际装的是sudo dnf install make git diffutils pkgconf \ gcc-riscv64-linux-gnu gcc-c-riscv64-linux-gnu \ binutils-riscv64-linux-gnu glibc-devel-riscv64-linux-gnu注意glibc-devel-riscv64-linux-gnu这个包它提供了目标系统的 C 库头文件和链接需要的 crt 文件。如果缺了这个后面 configure 阶段会出现找不到标准头文件的报错。安装完成后先验证一下工具链是否可用riscv64-linux-gnu-gcc -v能看到版本信息就说明基本没装错。再写个最小测试程序交叉编译后确认产物int main() { return 0; }riscv64-linux-gnu-gcc test.c -o test file test正常情况下输出会包含类似ELF 64-bit LSB executable, UCB RISC-V, RVC, double-float ABI的字样。到这里工具链就算跑通了。2.2 工具链版本与目标架构的匹配问题RISC-V 指令集发展很快工具链版本直接影响目标板子的兼容性。Fedora 仓库里的交叉工具链通常比较新如果你用的板子内核比较旧、或者板子的 SoC 只实现了基础整数指令集加乘除扩展RV64IMAC新工具链默认生成的目标文件可能在旧内核上加载失败报unknown reloc之类的链接错误。Fedora 仓库的 riscv64 工具链默认目标一般是 RV64GC也就是包含基础指令集、乘除、原子操作、单双精度浮点和压缩指令的完整组合。现在市面上主流的 RISC-V Linux 板子基本都支持 RV64GC所以直接用仓库自带的包问题不大。如果用的是很老的板子建议先查一下板子的 CPU 支持哪些指令集扩展再决定是否需要自己构建一套旧版本工具链。另外一个容易忽略的点是 ABI 风格。RISC-V Linux 下常见的 ABI 是 lp64d也就是 LP64 数据模型加双精度浮点调用约定。Fedora 的交叉包默认就是 lp64d如果板子浮点单元精度不够可能需要改成 lp64 或者 ilp32d这就得自己配置编译器的 multilib 了操作复杂度会上升不少。正常情况下直接默认就行但心里要有这根弦遇到文件加载类报错时先怀疑指令集和 ABI 不匹配。3. 拉取 FFmpeg 源码与 configure 策略3.1 源码获取与版本选择FFmpeg 官方推荐从 Git 仓库拉取源码这样能随时拿到最新特性。但如果追求稳定建议选发布版 tag。我这次用的是 n6.1 系列属于发布有一段时间的稳定版本新老特性平衡得比较好网上能搜到的资料也多。git clone https://git.ffmpeg.org/ffmpeg.git ffmpeg cd ffmpeg git checkout n6.1如果网络条件一般也可以去 ffmpeg.org 下载 release 源码包。Git 方式和压缩包方式对后续 configure 没有本质区别。源码拉下来之后先看一眼顶层目录里的 README 和 Changelog稍微了解当前版本包含什么特性。接下来最重要的步骤是运行 configure这一步会生成编译所需的 Makefile 和 config.h。交叉编译的 configure 参数能不能写对直接决定后面构建顺不顺利。3.2 configure 参数逐项拆解先给一份我实际使用的 configure 命令后面逐项解释./configure \ --archriscv64 \ --target-oslinux \ --enable-cross-compile \ --cross-prefixriscv64-linux-gnu- \ --prefix/opt/riscv-ffmpeg \ --disable-x86asm \ --disable-doc \ --disable-debug \ --disable-ffplay \ --enable-ffprobe \ --enable-small逐项说明--archriscv64告诉构建系统目标 CPU 架构是 RISC-V 64 位。这个参数会影响架构相关源码的选择比如一些与 CPU 特性有关的优化代码路径。--target-oslinux目标操作系统是 Linux。FFmpeg 支持的 OS 非常多从 Windows 到 Android 都有必须明确指定因为不同 OS 的进程调度接口、线程实现方式都有差异。--enable-cross-compile启用交叉编译模式。这是最关键的一个开关没有它FFmpeg 会默认你在为本机编译然后用宿主机的编译器去测各种特性大概率直接编译失败或者生成错误架构的二进制。--cross-prefixriscv64-linux-gnu-指定交叉编译工具链前缀。FFmpeg 会在这个前缀后面拼 gcc、ar、ranlib、strip 等工具名自动完成编译器、汇编器、链接器的选择和调用。相当于一次配置后面不再需要手动改 CC、AR 这些环境变量。--prefix/opt/riscv-ffmpeg指定安装路径。交叉编译的产物不要装到宿主机系统目录里否则会污染本机环境也容易和系统自带的 FFmpeg 冲突。装到一个独立目录后面拷到板子上也方便。--disable-x86asm禁止 x86 汇编优化。默认情况下 FFmpeg 会检测并使用 nasm/yasm 来加速 x86 平台的一些 hot path。RISC-V 平台用不上这些不关掉的话 configure 会报找不到汇编器或者直接识别异常。--disable-doc不生成文档减少构建时间。--disable-debug不包含调试符号产物体积更小。--disable-ffplayffplay 依赖 SDL 库交叉编译 SDL 又得多折腾一轮。不需要播放器功能的话直接关掉。--enable-ffprobe保留 ffprobe 工具这工具在调试媒体问题时太常用了建议留着。--enable-small优化产物体积代价是性能略有下降。对开发板场景来说存储和内存都紧张这个参数通常值得开。这些参数加到一起configure 就能在宿主机上生成一套目标架构为 RISC-V 的构建配置后续 make 命令直接使用这套配置完成编译链接中间不需要再手动指定工具链。3.3 外部库的取舍策略FFmpeg 功能强大很大程度上是因为它可以链接外部库比如 x264、x265、libvpx、libmp3lame 等等。但交叉编译环境下每个外部库都要单独为 RISC-V 目标架构编译一份这会把工作量扩大好几倍还可能引入一堆工具链兼容性问题。我的建议是分两步走。第一步先做一个不依赖任何外部库的最小版本把 FFmpeg 自带的编解码器跑通比如 H.264 解码走 FFmpeg 内置的 decoderAAC 也走内置实现。这个最小版本能正常工作了再评估要不要加外部库。如果确实需要 H.264 编码最简单的路径是交叉编译 x264。x264 依赖很少交叉编译配置相对简单git clone https://code.videolan.org/videolan/x264.git cd x264 ./configure --cross-prefixriscv64-linux-gnu- --hostriscv64-linux-gnu \ --disable-cli --enable-static make -j$(nproc)编译完成后把生成的 x264.h、x264_config.h 放到 sysroot 的 include 目录把 libx264.a 放到 sysroot 的 lib 目录再回到 FFmpeg 源码目录在 configure 命令末尾加上--enable-libx264 --enable-gpl。这里必须加--enable-gpl因为 x264 采用 GPL 许可证。但作为第一次交叉编译建议先不要加外部库。原因很简单外部库会引入大量 pkg-config 依赖和头文件依赖任何一个环节版本不匹配都会让报错内容变得极其难查。先把最小版本构建成功拿到成就感之后再逐个扩展体验会好很多。4. 完整编译流程与生成物处理4.1 执行 configure 并检查输出在 FFmpeg 源码目录里运行上一节给出的 configure 命令。正常结束时输出末尾会有一段配置摘要包含当前版本、支持的编解码器、可用的协议、外部库链接状态等信息。重点检查两处第一External libraries部分。如果没有启用额外库这里应该只有zlib之类的基础库且状态是yes。如果出现某些库是unknown或者no但你的需求里确实需要它那就得回到依赖环节检查。第二Architecture部分。确认显示riscv64而不是默认的x86_64。这个信息是 configure 根据--arch参数生成并写入配置的出现异常时会直接影响后续编译目录结构。configure 通过后执行make -j$(nproc)这里的$(nproc)会把宿主机全部 CPU 核心都用上。交叉编译时大部分编译工作是宿主机完成的目标板硬件规格反而不影响编译时间这也是交叉编译的另一个核心优势。编译过程可能持续几分钟到十几分钟不等取决于宿主机性能和启用的组件数量。编译日志里如果出现 error先别急着改代码绝大多数报错都跟工具链配置或者依赖缺失有关直接看错误提示对应的文件和行号再到第五节对应找解决方案。4.2 编译产物检查编译完成后在源码目录执行./ffmpeg -version这个命令有一个坑当前目录下的ffmpeg文件是刚刚生成的 RISC-V 二进制你在 x86 Fedora 宿主机上直接运行它shell 会尝试执行这个文件但系统无法识别 RISC-V 格式会报Exec format error。正确的验证方式是用file命令检查产物格式file ffmpeg输出里能看到类似这样的内容ELF 64-bit LSB executable, UCB RISC-V, version 1 (SYSV), statically linked, stripped当排除了动态链接、确认是 RISC-V 架构之后产物就能往目标板上放了。也可以先在本机试试用 QEMU 用户态运行sudo dnf install qemu-user-static qemu-riscv64 ./ffmpeg -version这样不用启动完整虚拟机系统就能直接在 x86 主机上执行 RISC-V 二进制。虽然速度比原生慢很多但验证基本功能够用。4.3 安装到独立目录与部署到开发板执行make install因为 configure 指定了--prefix/opt/riscv-ffmpeg所有产物会整齐地安装到/opt/riscv-ffmpeg/下面里面有bin、lib、include、share等目录。这个目录不会干扰宿主系统。把整个目录打包拷到目标板tar czf riscv-ffmpeg.tar.gz /opt/riscv-ffmpeg传到板子上之后解压如果产物是动态链接版本还需要保证板子上的动态链接器能找到 FFmpeg 依赖的共享库。最简单的办法是把/opt/riscv-ffmpeg/lib加进板子系统的库搜索路径或者在编译时直接make install到板子系统的/usr/local目录。如果希望产物完全不依赖目标板的库环境可以在 configure 时启用静态链接--disable-shared --enable-static静态链接的 ffmpeg 体积会大一些但部署时省心很多适合开发板这类环境容易被折腾的场景。我最后实际用的是半静态方案只静态链接了外部依赖库FFmpeg 自身组件仍然动态加载这样能在灵活性和依赖管理之间取得平衡。5. 常见问题排查与避坑记录5.1 运行时执行格式错误最常见的报错就是在 x86 宿主机上直接去跑交叉编译出来的二进制系统直接给一句cannot execute binary file或者Exec format error然后人就慌了以为自己编译错了。其实这是交叉编译的正常现象x86 内核不认识 RISC-V 的 ELF 格式。验证产物用file想要在宿主机里跑就用 qemu-user别去怀疑工具链坏了。5.2 configure 阶段找不到标准头文件报错内容一般是checking for x264... no ERROR: libx264 not found或者编译时出现fatal error: stdio.h: No such file or directory这是 sysroot 不完整导致的。交叉编译需要目标架构的 C 库头文件Fedora 上对应包是glibc-devel-riscv64-linux-gnu。如果装的是旧的工具链包可能有部分头文件没有配套跟上执行一次全量升级sudo dnf upgrade --refresh再看一下riscv64-linux-gnu-gcc编译测试文件能否通过如果测试文件能过说明 sysroot 基本完善只有 FFmpeg 报头文件缺失那就是某个特定依赖库的头文件问题需要查具体是哪一个。5.3 链接时出现 Relocation 错误编译到了链接阶段报错类似relocation R_RISCV_HI20 cannot be used against symbol xxx这通常是目标文件里混合了 RV32 和 RV64 的代码或者汇编代码与链接器版本不匹配。最常见的原因是工具链太新、FFmpeg 版本太旧或者反过来。解决办法有两种升级 FFmpeg 源码到最新 release或者回退工具链版本。从实际体验看升级 FFmpeg 源码比降级工具链更省事毕竟 FFmpeg 对 RISC-V 的支持一直在往前走老版本的问题在新版里基本都会被修掉。还有一种情况是启用了某个外部库该库用旧版汇编器编译生成的目标文件带有旧式 relocation新链接器不兼容。遇到这种就重点排查引入的外部库确认它们也是用同一套工具链、同一个 sysroot 编译出来的。5.4 pkg-config 路径混乱导致选错依赖交叉编译时pkg-config 默认会在宿主机系统目录里找.pc文件这就非常危险。假设你宿主机装了 libvpxpkg-config 找到了宿主机的 vpx.pc于是 FFmpeg 的 configure 报告找到了 libvpx但编译时用的却是 x86 的库文件最终链接报错或者生成畸形二进制。规避方法是给 configure 传递明确的 pkg-config 环境变量让它只搜索交叉编译环境的目录export PKG_CONFIG_LIBDIR/opt/riscv-sysroot/usr/lib/pkgconfig export PKG_CONFIG_PATH/opt/riscv-sysroot/usr/share/pkgconfigPKG_CONFIG_LIBDIR和PKG_CONFIG_PATH两个变量配合可以完全屏蔽宿主机 pkg-config 目录。注意设置完以后要重新运行 configure只改环境变量不重新 configure 是没有效果的FFmpeg 的配置结果已经固化在config.mak里了。5.5 使用 Fedora 平台特有包的小提示Fedora 的交叉工具链包版本和 Fedora 系统版本严格绑定。比如 Fedora 40 装的 gcc 交叉包和 Fedora 39 的工具链版本不同如果拿到旧版 Fedora 上编译产物去新版 Fedora 上做二次编译可能会因为系统库版本升级出现兼容性报错。这类问题没有通用解法最干净的做法是把构建过程固定在某个 Fedora 版本上用容器或者虚拟机保持环境一致。对我来说最常用的方案是写一个构建脚本把工具链安装、依赖检查、configure、make 全部串起来每次换新机器、新 Fedora 版本都能一键复现。这也是交叉编译项目里最值得投入的一环单次编译成功不算成功能重复构建才算。6. 针对不同 RISC-V 板卡的小规模构建经验补充如果目标板子的 CPU 不支持某些指令集扩展FFmpeg 在运行时可能会非法退出。可以在 configure 里针对特定 CPU 做优化--cpuriscv64更细致的调优可以用-mcpu参数传入 CFLAGS但这需要清楚了解目标 CPU 的微架构一般用户不建议乱加加错反而会导致运行时崩溃。另一个技巧是裁剪 FFmpeg 组件。开发板场景下通常只需要解码不需要编码或者只需要特定格式的封装解封装。可以在 configure 时加上--disable-encoders \ --disable-muxers \ --enable-demuxers \ --enable-parsers这样编译出的二进制体积能大幅缩小很多不必要的模块就不会被打包进去。我实际编译时还加过--disable-network如果板子上的应用不需要网络功能这个参数能再去掉一堆协议模块。裁剪前先想清楚应用需要什么裁剪后如果功能有缺失再回头打开对应模块重新编译。编译一次成本不高反复试几轮就知道自己的最小集是什么了。还有一点值得提的是FFmpeg 7.0 之后优化了 RISC-V 向量扩展支持如果你的板子 CPU 支持 V 扩展升级到新版本 FFmpeg 能享受到明显的性能提升。判断方法是在目标板上执行grep riscv /proc/cpuinfo如果能搜到rv64imafdcv或者更长的字符串说明 CPU 包含向量扩展值得用新版 FFmpeg 配合--extra-cflags-marchrv64gcv重新编译一次。7. 写在最后一次实践后的经验整理整个流程走下来最强烈的感受就是交叉编译本身不复杂复杂的是搞清楚“目标环境需要什么”再决定“宿主机上怎么配置”。工具链只负责把代码变成目标架构的二进制真正的核心决策都在 configure 这一步架构选什么、外部库要不要、裁剪到什么程度这些决策直接决定板子上的最终体验。如果你第一次做这件事我的建议是先放弃任何外部库和花哨优化把目标设为“能在 RISC-V 板子上跑通ffmpeg -version”。这一步走通了后面再考虑 x264、考虑汇编优化、考虑交叉编译 rust/cgo 程序都是水到渠成的事。反过来一上来就想一步到位编译出功能最全的版本很容易被各种依赖问题劝退。Fedora 做交叉编译宿主确实比很多发行版省心一套 dnf 命令就能把工具链装齐。以后有这类 RISC-V 媒体处理需求我不会再考虑把源码直接拷到板子上慢慢磨直接在 x86 机上跑一下交叉编译几分钟后拿成品走人这才是把工作站算力用在刀刃上的做法。
