1. 简介
在进行安卓音视频开发时,利用安卓NDK工具交叉编译FFmpeg,生成可供安卓平台调用的FFmpeg库是最基础的工作。本篇文章介绍了利用NDK进行FFmpeg编译的具体过程,以及如何在Linux和windows系统下交叉编译出适用于不同安卓平台的FFmpeg库文件。
2. 编译前的准备工作
无论是在Linux还是Windows系统下,进行FFmpeg编译都需要准备好NDK工具和FFmpeg源码文件:
NDK下载地址:
https://developer.android.google.cn/ndk/downloads
FFmpeg下载地址:
http://www.ffmpeg.org/download.html
如果是在Windows平台下进行交叉编译,还需要准备MinGW工具。
https://sourceforge.net/projects/mingw-w64/
注意事项:
①FFmpge需要下载.zip源码压缩文件
②NDK版本和FFmpeg版本要匹配,如果某一个版本太新或太久可能会导致后续交叉编译出现错误
下载完成后将两个文件夹放到同一路径下,如下图是我在Windows系统中的存放形式。
3. 创建并编写编译脚本
完成以上准备工作后,开始撰写编译脚本,这也是交叉编译的关键步骤。首先无论是在Linux系统还是Windows系统,都需要在ffmpeg源码文件夹下创建一个build_android.sh文件。创建完成后,下面分别介绍如何在Windows和ubuntu系统下编译用于不同安卓平台的FFmpeg库文件。
windows系统
build_android.sh文件的创建
以在Windows系统下创建一个适用于X86平台的FFmpeg库为例,打开build_android.sh文件,写入如下代码:#!/bin/bash
# 临时文件路径
export TMPDIR=`dirname $0`/tmpdir
# NDK路径
NDK=C:/FFmpeg/android-ndk-r21e
# API版本(Android API)
API=29
# arm aarch64 i686 x86_64,所属系统
ARCH=i686
# 编译针对的平台,可以根据自己的需求进行设置
# armv7a aarch64 i686 x86_64
PLATFORM=i686
TARGET=$PLATFORM-linux-android
# 工具链的路径,根据编译的平台不同而不同
TOOLCHAIN=$NDK/toolchains/llvm/prebuilt/windows-x86_64/bin
SYSROOT=$NDK/sysroot
# 编译文件输出路径
PREFIX=`dirname $0`/android_arm/$PLATFORM
CFLAG="-D__ANDROID_API__=$API -U_FILE_OFFSET_BITS -DBIONIC_IOCTL_NO_SIGNEDNESS_OVERLOAD -Os -fPIC -DANDROID -D__thumb__ -mthumb -Wfatal-errors -Wno-deprecated -mfloat-abi=softfp -marm"
mkdir -p $TMPDIR
build_one()
{
./configure \
--ln_s="cp -rf" \
--prefix=$PREFIX \
--cc=$TOOLCHAIN/$TARGET$API-clang \
--cxx=$TOOLCHAIN/$TARGET$API-clang++ \
--ld=$TOOLCHAIN/$TARGET$API-clang \
--target-os=android \
--arch=$ARCH \
--cpu=$PLATFORM \
--cross-prefix=$TOOLCHAIN/$ARCH-linux-android- \
--disable-asm \
--enable-cross-compile \
--enable-shared \
--disable-static \
--enable-runtime-cpudetect \
--disable-doc \
--disable-ffmpeg \
--disable-ffplay \
--disable-ffprobe \
--disable-doc \
--disable-symver \
--enable-small \
--enable-gpl --enable-nonfree --enable-version3 --disable-iconv \
--enable-jni \
--enable-mediacodec \
--disable-bsfs \
--disable-indevs --enable-indev=v4l2 \
--disable-outdevs \
--disable-filters \
--disable-postproc \
--extra-cflags="$CFLAG" \
--extra-ldflags="-marm"
}
build_one
make clean
make -j4
make install
其中需要注意NDK的路径需要修改为你自己电脑中存放NDK的路径。
运行build_android.sh文件
创建完成后,进入MinGW的安装文件夹下,按照路径/msys/1.0/找到msys.bat文件,双击运行:然后在命令行中进入刚刚创建的build_android.sh文件所在路径,通过./build_anroid.sh进行运行(如下图所示)
等待程序自己运行,如果运行成功会在脚本指定的路径下生成i686文件夹,里面包含了后续供安卓平台调用的头文件和共享库文件。(下图是我生成的应用于x86平台的FFmpeg库文件)
ubuntu系统
ubuntu系统下的交叉编译相比windows系统下更加方便。这里以编译一个适用于armeabi-v7a平台的FFmpge库为例。
build_android.sh文件的创建
同样在ffmpeg源码路径下创建一个build_andorid.sh文件#!/bin/bash
echo "进入编译ffmpeg脚本"
NDK=/root/ff/android-ndk-r14b
#5.0
PLATFORM=$NDK/platforms/android-21/arch-arm
TOOLCHAIN=$NDK/toolchains/arm-linux-androideabi-4.9/prebuilt/linux-x86_64
CPU=armv7-a
#输出路径
PREFIX=./android/$CPU
function buildFF
{
echo "开始编译ffmpeg"
./configure \
--prefix=$PREFIX \
--target-os=android \
--cross-prefix=$TOOLCHAIN/bin/arm-linux-androideabi- \
--arch=arm \
--cpu=$CPU \
--sysroot=$PLATFORM \
--extra-cflags="$CFLAG" \
--cc=$TOOLCHAIN/bin/arm-linux-androideabi-gcc \
--nm=$TOOLCHAIN/bin/arm-linux-androideabi-nm \
--enable-shared \
--enable-runtime-cpudetect \
--enable-gpl \
--enable-small \
--enable-cross-compile \
--disable-debug \
--disable-static \
--disable-doc \
--disable-ffmpeg \
--disable-ffplay \
--disable-ffprobe \
--disable-ffserver \
--disable-postproc \
--disable-avdevice \
--disable-symver \
--disable-stripping \
$ADD
make -j16
make install
echo "编译结束!"
}
###########################################################
echo "编译支持neon和硬解码"
CPU=armv7-a
PREFIX=./android/armv7-a-neon-hard
CFLAG="-I$PLATFORM/usr/include -fPIC -DANDROID -mfpu=neon -mfloat-abi=softfp "
ADD="--enable-asm \
--enable-neon \
--enable-jni \
--enable-mediacodec \
--enable-decoder=h264_mediacodec \
--enable-hwaccel=h264_mediacodec "
buildFF
###########################################################
echo "编译不支持neon和硬解码"
CPU=armv7-a
PREFIX=./android/$CPU
CFLAG="-I$PLATFORM/usr/include -fPIC -DANDROID -mfpu=vfp -mfloat-abi=softfp "
ADD=
buildFF
运行build_android.sh文件
在build_android.sh文件所在路径下打开命令行工具,直接输入./build_android.sh回车运行
运行成功后也会在指定目录下生成对应的库文件。
4. 在Android Studio中调用编译出的FFmpeg库
1. 在安卓项目中引入FFmpeg库
创建一个的安卓项目,将编译好的FFmpeg库放入项目的.../MyApplication/app/src/main/cpp路径下(包括生成的inclue文件夹和lib文件夹)。按照编译出的FFmpeg库版本对lib文件夹进行重命名,例如我在Windows下编译的FFmpeg是针对x86平台的,则lib文件夹重命名为x86。
此时,你的cpp路径下应该有如上图所示的几个子文件夹,其中include、CMakeList.txt、native-lib.cpp是必须要有的,其余中armeabi-7v、x86、x86_64可以只有一个,也可以多个都包含,这取决于你的应用所要配置的安卓平台,如果你只用配置在x86平台下,则只包含x86文件夹也可以。
2. 配置CMakeList.txt文件
首先需要在CMakeList.txt中配置include文件夹路径,由于CMakeList.txt和include在同一文件夹下,所以之间添加如下代码即可:#添加头文件路径(相对于本文件的路径)
include_directories(include)
然后需要配置ffmpeg动态库所在路径,这里分为三步实现:#设置ffmpeg库所在路径的变量
add_library(avcodec SHARED IMPORTED)
set_target_properties(avcodec PROPERTIES IMPORTED_LOCATION ${CMAKE_SOURCE_DIR}/${ANDROID_ABI}/libavcodec.so)
add_library(avformat SHARED IMPORTED)
set_target_properties(avformat PROPERTIES IMPORTED_LOCATION ${CMAKE_SOURCE_DIR}/${ANDROID_ABI}/libavformat.so)
add_library(avutil SHARED IMPORTED)
set_target_properties(avutil PROPERTIES IMPORTED_LOCATION ${CMAKE_SOURCE_DIR}/${ANDROID_ABI}/libavutil.so)
target_link_libraries( # Specifies the target library.
native-lib
avcodec
avformat
avutil
# Links the target library to the log library
# included in the NDK.
${log-lib} )
3. 配置build.gradle文件
在build.gradle中需要进行两项配置,第一项是在externalNativeBuild下添加ndk字段,如下所示:externalNativeBuild {
cmake {
cppFlags "-std=c++11"
}
ndk{
abiFilter "x86"
}
}
第二步是在externalNativeBuild 同级字段中添加动态库文件夹所在路径sourceSets {
main{
jniLibs.srcDirs=['src/main/cpp']
}
}
4. 在native-lib.cpp中进行库调用
在调用时首先需要引入头文件,这里需要注意,引入头文件时需要加上extern "C"关键字extern "C"{
#include "libavcodec/avcodec.h"
#include "libavformat/avformat.h"
#include "libavutil/pixfmt.h"
}