企业官网建设流程全解析

mp4parser4cj鸿蒙实战：FFmpeg交叉编译aarch64-linux-ohos，3步完成OHOS部署

【免费下载链接】mp4parser4cj一个读取、写入操作音视频文件编辑的工具项目地址: https://gitcode.com/Cangjie-TPC/mp4parser4cj

mp4parser4cj 是一个用仓颉语言编写的音视频文件编辑工具，一行代码即可完成 mp4 视频的合成、裁剪、批量合成与 mp3 音频的同类操作。它的核心是一个构建在 FFmpeg 之上的动态库，因此要把它部署到鸿蒙（OHOS）真机，绕不开一个关键动作——FFmpeg 交叉编译 aarch64-linux-ohos。本文带你用 3 步走完全流程，不绕弯路。

为什么必须交叉编译 FFmpeg？

与"spawn 一个 ffmpeg 命令行进程"的工具不同，mp4parser4cj 通过 C FFI 直接调用 FFmpeg 库内部函数：src/mp4parsers.cj 中的ffmpeg_exec会把命令字符串拆分后交给 FFmpeg 库内的c_ffmpeg_exec入口执行。

这意味着你需要一个编译到目标架构的"特殊版" FFmpeg 动态库，它具备两个特点：

• 🎯可交叉编译：同一套流程可产出 Linux x86_64、Windows 与 aarch64-linux-ohos 三套库，编译入口见 README.md
• 🎬功能完整：覆盖视频/音频剪辑六大功能（明细见 doc/feature_api.md）

整体架构很清晰：仓颉类层（MP4Parser业务方法 +FileUtils路径校验，见 src/fileutils.cj）构建在 FFmpeg core 动态库层之上。

第一步：修补 FFmpeg 源码，加入仓颉调用入口

先克隆仓库，准备一套 FFmpeg 源码：

git clone https://gitcode.com/Cangjie-TPC/mp4parser4cj

在 Linux 或 msys2 中进入 FFmpeg 根目录，执行以下修补脚本（完整版本见 README.md）：

sed -i '/PROGS)/,/endif/d' Makefile && sed -i 's/%$(PROGSSUF)_g$(EXE/lib%$(PROGSSUF)$(SLIB/' Makefile && sed -i '/$(OBJS-$\*) $(FF_EXTRALIBS)/a \\t$(STRIP) $@' Makefile sed -i 's/=%$(PROGSSUF).*$(EXESUF)/=lib%$(PROGSSUF)$(SLIBSUF)/g' fftools/Makefile && sed -i 's/$(1)$(PROGSSUF)_g$(EXESUF)/lib$(1)$(PROGSSUF)$(SLIBSUF)/g' fftools/Makefile && sed -i 's/$(LDFLAGS-$(1))/$(LDFLAGS-$(1)) -shared/' fftools/Makefile sed -i 's/^int main/int ffmpeg_exec/' fftools/ffmpeg.c && sed -i '$a \nint c_ffmpeg_exec(char *str)\n{\n char *tmp = strtok(str, " ");\n int i = 0;\n char *argv[] = {0};\n argv[i] = tmp;\n while (tmp != NULL) {\n i++;\n tmp = strtok(NULL, " ");\n argv[i] = tmp;\n }\n return ffmpeg_exec(i, argv);\n}' fftools/ffmpeg.c sed -i '/#endif.*FFTOOLS_FFMPEG_H/i\int c_ffmpeg_exec(char *str);\nint ffmpeg_exec(int argc, char **argv);\n' fftools/ffmpeg.h

它做了两件事，理解这两点就不会迷路：

1. 改 Makefile：把 ffplay、ffprobe 等程序型目标从可执行文件改为共享库（-shared）产出
2. 改 ffmpeg.c/ffmpeg.h：把int main重命名为ffmpeg_exec，并新增c_ffmpeg_exec(char *str)—— 自动按空格拆分命令字符串并转发调用，这就是仓颉 FFI 的入口

第二步：FFmpeg 交叉编译 aarch64-linux-ohos

仍处在 FFmpeg 根目录，执行（工具链路径请按你的环境替换，/usr1/ohos/llvm/仅为示例，见 README.md）：

./configure --target-os=linux --arch=aarch64 --enable-cross-compile \ --disable-doc --disable-manpages --disable-htmlpages \ --disable-podpages --disable-txtpages --disable-ffplay --disable-ffprobe \ --extra-cflags=-fPIC --disable-asm \ --extra-cflags="-I/usr1/ohos/llvm/include/aarch64-linux-ohos --target=aarch64-linux-ohos" \ --extra-ldflags="--target=aarch64-linux-ohos" \ --cc="/usr1/ohos/llvm/bin/clang" \ --ar="/usr1/ohos/llvm/bin/llvm-ar" \ --ranlib="/usr1/ohos/llvm/bin/llvm-ranlib" \ --strip="/usr1/ohos/llvm/bin/llvm-strip" make

参数速读 📖：

make完成后，你会得到一批aarch64-linux-ohos架构的.so动态库。

第三步：编译 mp4parser4cj 并验证部署

1. 放置动态库：把上一步生成的.so文件（如libcrypto.so等）放进项目根目录的 lib/ 下。构建文件 cjpm.toml 已声明ffmpeg的 FFI 搜索路径为./lib/，无需额外配置。

2. 选择一种方式编译：

• ⚡cjpm 编译（推荐）：仓库的 cjpm.toml 已预置aarch64-linux-ohos目标，编译参数均引用DEVECO_CANGJIE_HOME环境变量。你只需：
  1. 导出DEVECO_CANGJIE_HOME指向 DevEco 的仓颉工具链目录；
  2. 按 stdx 文档配置CANGJIE_STDX_PATH（ohos 目标会读取其下linux_ohos_aarch64_llvm/dynamic/stdx）；
  3. 执行cjpm build
• 🛠️脚本编译：下载配置 TPC-Test-Framework 编译脚本后执行ciTest build

3. 验证：写一个最小用例调用一次剪辑，例如：

import std.io.* import mp4parser.* main() { var b = MP4Parser() let ret = b.videoMerge("./a.mp4", "./out.mp4") if (ret == 1) { println("success") } }

编译后在 OHOS 环境运行，输出success即代表 FFmpeg 动态库与仓颉库都正确加载 🎉。

实战小贴士

• 编译报找不到 stdx？检查CANGJIE_STDX_PATH是否指向了linux_ohos_aarch64_llvm对应目录，ohos 目标与 Linux 桌面目标用的 stdx 并不相同
• 链接时提示符号缺失？确认lib/下的.so确实是aarch64-linux-ohos架构产出，可用file命令快速核对
• 版本要求：当前 v1.0.2 适配仓颉 1.1.3，版本演进见 CHANGELOG.md；项目基于 Apache License 2.0 开源（LICENSE）

三步走完，mp4parser4cj 就已经跑在你的鸿蒙设备上了。后续若需要扩展剪辑参数或新增封装格式，可直接在 src/mp4parsers.cj 中按现有模式追加方法，FFmpeg 底层能力已经就位。

【免费下载链接】mp4parser4cj一个读取、写入操作音视频文件编辑的工具项目地址: https://gitcode.com/Cangjie-TPC/mp4parser4cj