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
打开 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
作用:
- 绕过 configure对 Clang 的严格检测。
- 利用 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_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



















