FFMPEG学习第一篇--android studio 2.3 Cmake 编译并使用ffmpeg的动态so库

最近萌生了学习视频的想法,遂在网上找了文章来看,才知道曾经有过雷神的存在。雷神的博客激励着一波又一波走向音视频编码的程序员,看着他写的博客,心中对ffmpeg开源项目,不免升起一种难以割舍的情愫。

网上关于FFMPEG的编译so库教程很多,最开始走了很多弯路,导致编译不成功,最后尽管编译成功了,应用到android studio上,还是无法实现雷神的那个简单的hello ffmpeg的项目。最后在这两篇博客的启发下,终于还是写出来了。最纯粹的直播技术实战01-FFmpeg的编译与运行,以及最简单的android studio 2.3 引用FFmpeg例子程序。前者是将ffmpeg编译成了静态库,后者是通过将ffmpeng编译成了动态库,虽然在android studio的jni中引用的库的方式不一样,但是殊途同归。

一:mac环境下的ffmpeg的编译

ffmpeng的编译,一般是通过脚本来实现。当我们从ffmpeg的官网上下载了最新的源码之后,可以在源码的根目录下创建一个.sh的文件。由于我将ffmpeg的源码放在了这个位置/Users/xiaguangcheng/ffmpeg/ffmpeg/,因此我的脚本文件就是ffmpegbuild.sh:

#!/bin/bash
export TMPDIR=/Users/xiaguangcheng/ffmpeg/ffmpeg/ffmpegtemp
NDK=/Users/xiaguangcheng/android/android-sdk-macosx/ndk-bundle
SYSROOT=$NDK/platforms/android-18/arch-arm/
TOOLCHAIN=$NDK/toolchains/arm-linux-androideabi-4.9/prebuilt/darwin-x86_64
CPU=arm
PREFIX=/Users/xiaguangcheng/ffmpeg/ffmpeg/android
ADDI_CFLAGS="-marm"
function build_one
{
./configure \
--prefix=$PREFIX \
--enable-shared \
--enable-gpl \
--disable-static \
--disable-doc \
--disable-ffmpeg \
--disable-ffplay \
--disable-ffprobe \
--disable-ffserver \
--disable-doc \
--disable-symver \
--enable-small \
--cross-prefix=$TOOLCHAIN/bin/arm-linux-androideabi- \
--target-os=linux \
--arch=arm \
--enable-cross-compile \
--sysroot=$SYSROOT \
--extra-cflags="-Os -fpic $ADDI_CFLAGS" \
--extra-ldflags="$ADDI_LDFLAGS" \
$ADDITIONAL_CONFIGURE_FLAG
make clean
make
make install
}
build_one

这里需要注意的几点:

  • TMPDIR 对应的ffmpegtemp是一个文件夹,需要自己手动创建,不然会有异常等你。
  • NDK的位置需要配置你自己的。
  • SYSROOT 和TOOLCHAIN同样的道理。
  • PREFIX 是打包生成的so文件和.h头文件的位置。
  • 在编译之前需要将ffmpeg文件夹下的configure文件中的部分字段进行修改,引用的那两篇文章中都有详细说明。

有时候编译还需要yasm,因此可以先通过homebrew 安装yasm

brew install yasm

配置完成之后,我们就可以cd到当前ffmpeg的根目录,通过运行

./ffmpegbuild.sh

的方式启动这个编译过程。

之后就可以生成这样的一个文件夹:

《FFMPEG学习第一篇--android studio 2.3 Cmake 编译并使用ffmpeg的动态so库》 image.png

二:通过android studio2.3 完成对ffmpeg so库的调用

  • (一)获取Cmake
    由于在android studio2.2之后,官方就推荐我们使用Cmake来编译原生库,因此我们首先应该下载并安装Cmake。这一点android stuido在SDK Tools中,已经为我们提供了方便获得的渠道,只要我们打勾下载就可以了。

《FFMPEG学习第一篇--android studio 2.3 Cmake 编译并使用ffmpeg的动态so库》 image.png

  • (二)创建一个包含c++的项目
    在我们创建新项目的时候,记得勾选include c++ support,不然里面的一些文件以及文件夹就需要我们手动创建,虽然这样也可以。然后就是一路绿灯加速前进了。

《FFMPEG学习第一篇--android studio 2.3 Cmake 编译并使用ffmpeg的动态so库》 image.png

  • (三)依赖ffmpeg 的so库和头文件
    我们把前面生成的ffmpeg的so和头文件拷贝到项目中来,记得添加到对应的文件夹中。so放在自己手动创建的jniLibs/armeabi中。头文件放在自己手动创建的ffmpeg3/include中。

    《FFMPEG学习第一篇--android studio 2.3 Cmake 编译并使用ffmpeg的动态so库》 image.png

  • (四)配置CMakeLists.txt 文件。
    由于项目采用了CMake来管理C++原生代码,因此我们还需要来配置该文件。具体的CMake使用方法,可以参看 CMake的官方文档。下面贴出本项目的配置。
cmake_minimum_required(VERSION 3.4.1)
set(lib_src_DIR ${CMAKE_SOURCE_DIR}/src/main/jniLibs/${ANDROID_ABI})

add_library(native-lib  SHARED src/main/cpp/native-lib.cpp)
add_library(avcodec-57 SHARED IMPORTED)
add_library(avformat-57 SHARED IMPORTED)
add_library(avutil-55 SHARED IMPORTED)
add_library(swresample-2 SHARED IMPORTED)
add_library(swscale-4 SHARED IMPORTED)

set_target_properties(avcodec-57 PROPERTIES IMPORTED_LOCATION
${lib_src_DIR}/libavcodec-57.so)
set_target_properties(avformat-57 PROPERTIES IMPORTED_LOCATION
${lib_src_DIR}/libavformat-57.so)
set_target_properties(avutil-55 PROPERTIES IMPORTED_LOCATION
${lib_src_DIR}/libavutil-55.so)
set_target_properties(swresample-2 PROPERTIES IMPORTED_LOCATION
${lib_src_DIR}/libswresample-2.so)
set_target_properties(swscale-4 PROPERTIES IMPORTED_LOCATION
${lib_src_DIR}/libswscale-4.so)

include_directories(${CMAKE_SOURCE_DIR}/src/main/cpp/ffmpeg3/include)

find_library(log-lib log )
target_link_libraries(  native-lib ${log-lib} avcodec-57
avformat-57
avutil-55
swresample-2
swscale-4)
  • (五)app的gradle文件配置
    如果是通过studio生成的c++原生库,那么会在module的build.gradle中自动配置好Cmake的路径。
externalNativeBuild {
        cmake {
            path "CMakeLists.txt"
        }
    }

我们需要做的就是再添加一些参数

defaultConfig {
     
        externalNativeBuild {
            cmake {
                cppFlags ""
                arguments '-DANDROID_TOOLCHAIN=clang','-DANDROID_STL=gnustl_static'
            }
        }

        ndk{
            abiFilters 'armeabi'
        }
    }
  • (六)编写 C++代码
    项目创建的时候自动为我们配置了一个简单的stringFromJNI的方法,我们就在native-lib.cpp文件中,手动改写这个方法来获取ffmpeg中的一些配置信息。
#include <jni.h>
#include <string>
extern "C"{
#include "libavcodec/avcodec.h"
};
extern "C"
JNIEXPORT jstring JNICALL
Java_com_fengfutong_cmakedemo_MainActivity_stringFromJNI(JNIEnv *env,
                                                       jobject /* this */)
{
    char info[10000] = {0};
    sprintf(info, "%s\n", avcodec_configuration());
    return env->NewStringUTF(info);
}

三:运行app

《FFMPEG学习第一篇--android studio 2.3 Cmake 编译并使用ffmpeg的动态so库》 image.png

当你的手机出现这个页面,也就到了我们第一篇说再见的时候了。祝君好运,下期再会。

点赞