音视频学习：使用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/bash

    echo ">>>>>>>>> 编译硬件解码版本 <<<<<<<<"
    #替换为你自己的NDK路径.
    export NDK=/home/xaye/Android/Sdk/ndk/android-ndk-r22
    TOOLCHAIN=$NDK/toolchains/llvm/prebuilt/linux-x86_64


    function 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 clean
    make
    make install

    echo "编译成功 $CPU"

    }

    #armv8-a
    ARCH=arm64
    CPU=armv8-a
    API=21
    CC=$TOOLCHAIN/bin/aarch64-linux-android$API-clang
    CXX=$TOOLCHAIN/bin/aarch64-linux-android$API-clang++
    SYSROOT=$NDK/toolchains/llvm/prebuilt/linux-x86_64/sysroot
    CROSS_PREFIX=$TOOLCHAIN/bin/aarch64-linux-android-
    PREFIX=$(pwd)/android/$CPU
    OPTIMIZE_CFLAGS="-march=$CPU"

    build_android

    #armv7-a
    ARCH=arm
    CPU=armv7-a
    API=16
    CC=$TOOLCHAIN/bin/armv7a-linux-androideabi$API-clang
    CXX=$TOOLCHAIN/bin/armv7a-linux-androideabi$API-clang++
    SYSROOT=$NDK/toolchains/llvm/prebuilt/linux-x86_64/sysroot
    CROSS_PREFIX=$TOOLCHAIN/bin/arm-linux-androideabi-
    PREFIX=$(pwd)/android/$CPU
    OPTIMIZE_CFLAGS="-mfloat-abi=softfp -mfpu=vfp -marm -march=$CPU "

    build_android

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_LIBS
        avutil
        swresample
        avcodec
        avformat
        swscale
        # 可选添加其他库：postproc, avfilter 等
)

# 导入预编译的 FFmpeg 共享库
foreach(LIB ${FFMPEG_LIBS})
    add_library(${LIB} SHARED IMPORTED)
    set_target_properties(${LIB} PROPERTIES
            IMPORTED_LOCATION "${FFMPEG_LIBS_DIR}/lib${LIB}.so"
            # 对于 Android 8.0+ 需要设置 SONAME
            IMPORTED_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_jni
        android
        ${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