音视频学习：使用NDK编译FFmpeg动态库

1. 环境

1.1 基础配置

• NDK 22b (r22b)
• FFmpeg 4.4
• Ubuntu 22.04

1.2 下载ffmpeg

官网提供了 .tar.xz 包，可以直接下载解压：

wget https://ffmpeg.org/releases/ffmpeg-4.4.tar.xz
tar -xvf ffmpeg-4.4.tar.xz
cd ffmpeg-4.4

1.3 安装基础工具链

sudo apt-get update && sudo apt-get install \
build-essential autoconf automake libtool \
pkg-config cmake git wget unzip yasm

可能不包含全部，遇到报错缺少的工具链的，把报错抛给AI，按提示下载即可：）

---

2. 编译脚本配置

注意将脚本中的 export NDK 换成自己的路径

 #!/bin/bashecho ">>>>>>>>> 编译硬件解码版本 <<<<<<<<"#替换为你自己的NDK路径.export NDK=/home/xaye/Android/Sdk/ndk/android-ndk-r22TOOLCHAIN=$NDK/toolchains/llvm/prebuilt/linux-x86_64function build_android{echo "开始编译 $CPU"./configure \--prefix=$PREFIX \--enable-neon  \--enable-hwaccels  \--enable-gpl   \--enable-postproc \--enable-shared \--disable-debug \--enable-small \--enable-jni \--enable-mediacodec \--enable-decoder=h264_mediacodec \--disable-static \--disable-doc \--enable-ffmpeg \--disable-ffplay \--disable-ffprobe \--disable-avdevice \--disable-doc \--disable-symver \--cross-prefix=$CROSS_PREFIX \--target-os=android \--arch=$ARCH \--cpu=$CPU \--cc=$CC \--cxx=$CXX \--enable-cross-compile \--sysroot=$SYSROOT \--extra-cflags="-Os -fpic $OPTIMIZE_CFLAGS" \--extra-ldflags="$ADDI_LDFLAGS"make cleanmakemake installecho "编译成功 $CPU"}#armv8-aARCH=arm64CPU=armv8-aAPI=21CC=$TOOLCHAIN/bin/aarch64-linux-android$API-clangCXX=$TOOLCHAIN/bin/aarch64-linux-android$API-clang++SYSROOT=$NDK/toolchains/llvm/prebuilt/linux-x86_64/sysrootCROSS_PREFIX=$TOOLCHAIN/bin/aarch64-linux-android-PREFIX=$(pwd)/android/$CPUOPTIMIZE_CFLAGS="-march=$CPU"build_android#armv7-aARCH=armCPU=armv7-aAPI=16CC=$TOOLCHAIN/bin/armv7a-linux-androideabi$API-clangCXX=$TOOLCHAIN/bin/armv7a-linux-androideabi$API-clang++SYSROOT=$NDK/toolchains/llvm/prebuilt/linux-x86_64/sysrootCROSS_PREFIX=$TOOLCHAIN/bin/arm-linux-androideabi-PREFIX=$(pwd)/android/$CPUOPTIMIZE_CFLAGS="-mfloat-abi=softfp -mfpu=vfp -marm -march=$CPU "build_android

打开 FFmpeg 根目录的 configure 文件，搜索关键字 cc_default="clang" 将 clang 改为 gcc，不修改的话编译会报错！

//1. 修改 configure 文件
vim configure
//2. 把 默认的 clang 修改为 gcc
if test "$target_os" = android; then# cc_default="clang"cc_default="gcc"
fi

作用：

1. 绕过 configure 对 Clang 的严格检测。
2. 利用 NDK 的 gcc 脚本的兼容性层，解决某些编译问题。

这一修改是针对旧版 FFmpeg 在 NDK r22 环境下的临时解决方案，本质是利用 NDK 的 gcc 包装器间接调用 Clang

---

3. 执行编译

# 赋予执行权限
chmod +x build_android.sh# 开始编译（约10-30分钟）
./build_android.sh

编译完成后，会生成 android/armv7-a 和 android/armv8-a 目录，结构如下

android/├── armv7-a/│   ├── lib/*.so│   └── include/   <-- FFmpeg 头文件└── armv8-a/├── lib/*.so└── include/

这些 .so 文件，分别对应：

• armv7-a/ → 用于 Android 项目的 armeabi-v7a
• armv8-a/ → 用于 Android 项目的 arm64-v8a

---

4. Android 项目配置

修改 build.gradle，启用 NDK 支持

 android {defaultConfig {externalNativeBuild {cmake {cppFlags "-std=c++11"abiFilters 'armeabi-v7a', 'arm64-v8a'}}}externalNativeBuild {cmake {path "CMakeLists.txt"}}ndkVersion '22.0.7026061'}

放入头文件

将 FFmpeg 头文件复制到 app/src/main/cpp/ 下，就是把上面编译生成的整个 include 文件夹复制进去，不用在意v7a还是v8a，头文件接口都是一样的。

创建 CMakeLists.txt

在 app/ 目录下创建：

# 最低 CMake 版本要求
cmake_minimum_required(VERSION 3.4.1)# 项目设置
project("ffmpeg_jni")# 设置 C 标准（FFmpeg 需要 C11）
set(CMAKE_C_STANDARD 11)
set(CMAKE_CXX_STANDARD 11)# 打印当前 ABI 用于调试
message("Current ABI: ${ANDROID_ABI}")# 设置 FFmpeg 库路径（根据实际路径调整）
set(FFMPEG_LIBS_DIR ${CMAKE_SOURCE_DIR}/src/main/jniLibs/${ANDROID_ABI})# 定义 FFmpeg 核心库（按依赖顺序）
set(FFMPEG_LIBSavutilswresampleavcodecavformatswscale# 可选添加其他库：postproc, avfilter 等
)# 导入预编译的 FFmpeg 共享库
foreach(LIB ${FFMPEG_LIBS})add_library(${LIB} SHARED IMPORTED)set_target_properties(${LIB} PROPERTIESIMPORTED_LOCATION "${FFMPEG_LIBS_DIR}/lib${LIB}.so"# 对于 Android 8.0+ 需要设置 SONAMEIMPORTED_SONAME "lib${LIB}.so")message("Imported lib: ${FFMPEG_LIBS_DIR}/lib${LIB}.so")
endforeach()# 添加 Android 日志库
find_library(log-lib log)# 设置 JNI 源文件
file(GLOB JNI_SOURCES src/main/cpp/*.cpp)# 创建 JNI 库
add_library(ffmpeg_jni SHARED ${JNI_SOURCES})# 头文件包含路径（根据 FFmpeg 头文件位置调整）
target_include_directories(ffmpeg_jni PRIVATE${CMAKE_SOURCE_DIR}/src/main/cpp/include  # 头文件放在这里${CMAKE_SOURCE_DIR}/src/main/jniLibs/${ANDROID_ABI}/include  # 如果 FFmpeg 头文件随库提供
)# 链接库
target_link_libraries(ffmpeg_jniandroid${log-lib}${FFMPEG_LIBS}  # 按依赖顺序自动链接
)# 编译选项优化
target_compile_options(ffmpeg_jni PRIVATE-Wall-Werror-fno-exceptions-fno-rtti-fvisibility=hidden
)

---

5. JNI 代码实现

Java 层声明

创建 FFmpegHelper.java：

public class FFmpegHelper {static {// 按依赖顺序加载FFmpeg库System.loadLibrary("avutil");System.loadLibrary("swresample");System.loadLibrary("avcodec");System.loadLibrary("avformat");System.loadLibrary("swscale");System.loadLibrary("ffmpeg_jni"); // 我们的JNI库}public static native String getFFmpegVersion();
}

Native 层实现

创建 ffmpeg_jni.cpp：

#include <jni.h>
#include <android/log.h>
//#include <libavutil/avutil.h>
#include <stdio.h>extern "C" {
#include <libavutil/avutil.h>
}#define LOG_TAG "FFmpegJNI"
#define LOGD(...) __android_log_print(ANDROID_LOG_DEBUG, LOG_TAG, __VA_ARGS__)extern "C" {
JNIEXPORT jstring JNICALL
Java_com_xaye_compiler_FFmpegHelper_getFFmpegVersion(JNIEnv *env, jclass clazz) {// 调用FFmpeg API获取版本信息const char* version = av_version_info();LOGD("Native FFmpeg version: %s", version);return env->NewStringUTF(version ? version : "Unknown");
}
}

注意：在#include ffmpeg 库的头文件时，要使用 extern "C" 包起来，不然会报错！

---

6. 验证

在主界面 打印版本号

  Log.i("MainActivity", " FFmpeg version : "+FFmpegHelper.getFFmpegVersion());

输出：

---

代码已上传 ffmpeg-compiler

参考：音视频学习 (六) 一键编译 32/64 位 FFmpeg 4.2.2