May 13 2018

最新靠谱可用的 Mac 环境下 FFmpeg 环境搭建

大家好，我是光源。

最近在尝试搭建 FFmpeg 开发环境时遇到一个蛋疼的事，Google 了 N 篇文章竟然没有一篇是可以跑起来的！

少部分教程是给出了自我矛盾的配置（是的，按照贴出来的代码和配置，他自己都跑不起来），大部分教程是看着挺全但忽略了某几个关键的点导致跑不起来，更蛋疼的是碰到报错后错误相关的文章也很少，当然还有一些是年代久远过时了。

于是在成功跑起来后，我将整个搭建过程整理出来，希望可以帮到后面的人。

本文基于 Mac OS X + Android Studio 3.2 + FFmpeg 3.3 + CMake。

文章会分为两部分，第一部分是总结一下碰到的几个坑，这样只是因为报错而无法继续的朋友可以先看看是否可以解决问题；第二部分是搭建过程的完整描述（我特意用另一台电脑测试过，可以完美跑起来）。

一、FFmpeg 搭建的常见问题

1. NDK 的问题

在编译之前，教程都会让我们修改命令中 NDK 的地址为自己本地的地址，我们当然自然而然地改成了 Android Studio 自带的 ndk-bundle。

然后编译的时候就发现会出现errno.h: No such file or directory字样的error。

这是因为 Android Studio 自带的 NDK 缺少相关的 .h 文件，从网上额外下载 NDK 然后编译时使用就可以解决问题。（基于 FFmpeg 3.3）

2. 编译命令的问题

报错信息形如

1
2
3

ffmpeg_build.sh: line 14: ./configure: No such file or directory

ffmpeg_build.sh: line 20: --extra-cflags=-Os -fpic -marm: command not found

之类的，请检查一下 Android 编辑脚本的 “/” 后是否有空格。

由于不同系统存在差异，最好找对应系统下他人验证可行的编译命令。

3. 编译相关的版本

编译过程有 NDK 版本、Android 版本、FFmpeg 版本、Android Studio 版本等，不同版本存在差异，最好是完全使用教程描述时的版本。

比如编译命令中包含的 Android 版本

1	export SYSROOT=$NDK/platforms/android-21/arch-arm/

这里的 android-21 改成 26 就不行，因为搜索了这两个文件夹只有 21 中有需要的 .h 文件。

4. 项目构建配置

需要将相关的 .so 文件和 include 文件夹（里面包含一些头文件）都放入 libs 文件夹中，并在 gradle 文件夹中指定 jni 目录，最后编写 CMake 文件，缺少一步就报错

二、FFmpeg 环境配置最佳实践

1. 下载 FFmpeg 源码

1	git clone https://git.ffmpeg.org/ffmpeg.git

再切到 3.3 分支

1	git checkout -b 3.3 remotes/origin/release/3.3

2. 修改 configure 文件

在下载好的 ffmpeg 文件夹内可以找到一个 configure 文件，将其中的：

SLIBNAME_WITH_MAJOR='$(SLIBNAME).$(LIBMAJOR)'  
LIB_INSTALL_EXTRA_CMD='$$(RANLIB)"$(LIBDIR)/$(LIBNAME)"'  
SLIB_INSTALL_NAME='$(SLIBNAME_WITH_VERSION)'  
SLIB_INSTALL_LINKS='$(SLIBNAME_WITH_MAJOR)$(SLIBNAME)'

修改成

SLIBNAME_WITH_MAJOR='$(SLIBPREF)$(FULLNAME)-$(LIBMAJOR)$(SLIBSUF)'  
LIB_INSTALL_EXTRA_CMD='$$(RANLIB)"$(LIBDIR)/$(LIBNAME)"'  
SLIB_INSTALL_NAME='$(SLIBNAME_WITH_MAJOR)'  
SLIB_INSTALL_LINKS='$(SLIBNAME)'

3. 下载 NDK

就如上文所述，Android Studio 自带的 NDK 缺少部分 .h 文件，不确定是否跟 Android Studio 的版本或者 NDK 版本有关，也不确定是否所有人都这样。但为了简单，还是下载吧（下载下来的的这个 NDK 只为了编译 FFmpeg，不影响之前的 NDK）。

可以选择去官网下载，我找了个国内的 Android NDK下载(r10d r13b r14b)

下载适用于 Mac OS X 的 android-ndk-r14b-darwin-x86_64.zip 文件。

4. 编写编译脚本

在 ffmpeg 文件夹根目录下创建一个 ffmpeg_build.sh 文件（名称跟配置不相关，想改可以改），具体内容如下：

#!/bin/bash
make clean
# NDK的路径，根据自己的安装位置进行设置
export NDK=/Users/yanzhenghui/Downloads/android-ndk
export SYSROOT=$NDK/platforms/android-21/arch-arm/
export TOOLCHAIN=$NDK/toolchains/arm-linux-androideabi-4.9/prebuilt/darwin-x86_64
export CPU=arm
export PREFIX=$(pwd)/android/$CPU
export ADDI_CFLAGS="-marm"
function build_one
{
./configure \
    --prefix=$PREFIX \
    --target-os=linux \
    --cross-prefix=$TOOLCHAIN/bin/arm-linux-androideabi- \
    --arch=arm \
    --sysroot=$SYSROOT \
    --extra-cflags="-Os -fpic $ADDI_CFLAGS" \
    --extra-ldflags="$ADDI_LDFLAGS" \
    --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-asm \
    --disable-ffmpeg \
    --disable-ffplay \
    --disable-ffprobe \
    --disable-ffserver \
    --enable-postproc \
    --enable-avdevice \
    --disable-symver \
    --disable-stripping \
$ADDITIONAL_CONFIGURE_FLAG
sed -i '' 's/HAVE_LRINT 0/HAVE_LRINT 1/g' config.h
sed -i '' 's/HAVE_LRINTF 0/HAVE_LRINTF 1/g' config.h
sed -i '' 's/HAVE_ROUND 0/HAVE_ROUND 1/g' config.h
sed -i '' 's/HAVE_ROUNDF 0/HAVE_ROUNDF 1/g' config.h
sed -i '' 's/HAVE_TRUNC 0/HAVE_TRUNC 1/g' config.h
sed -i '' 's/HAVE_TRUNCF 0/HAVE_TRUNCF 1/g' config.h
sed -i '' 's/HAVE_CBRT 0/HAVE_CBRT 1/g' config.h
sed -i '' 's/HAVE_RINT 0/HAVE_RINT 1/g' config.h
make clean
# 这里是定义用几个CPU编译，我用4个，一般在5分钟之内编译完成
make -j4
make install
}
build_one

需要更改的是这个：

1 2	# NDK的路径，根据自己的安装位置进行设置 export NDK=/Users/yanzhenghui/Downloads/android-ndk

改成你本地的路径。

5.执行脚本

从命令行进入 ffmpeg 文件夹后，先执行

1	chmod +x ffmpeg_build.sh

命令给脚本开启权限，再执行编译脚本：

1	./ffmpeg_build.sh

等待编译完成，即可在 ffmpeg 文件夹内看到 android 文件夹，里面包含了我们需要的 .so 文件和对应的头文件

6.配置 ffmpeg 项目

这部分 Android - FFmpeg & Mac & AndroidStudio & CMake 环境搭建这篇文章写得足够好，我就不重复造轮子了，下面摘抄部分权当转载了。（当然，我也全部测试过能跑起来）

6.1 新建项目

新建一个以 CMake 方式构建的 C++ 项目（记得勾选 Include C++ Support）

6.2 拷贝文件到 libs 目录下

将编译好的 .so 和头文件拷贝到 libs 目录下：

6.3 指定 jniLibs 路径

android {
    ...
    sourceSets {
        main {
            jniLibs.srcDirs = ['libs']
        }
    }
}

6.4 配置 abiFilters

因为我们只编译出 armeabi-v7a 的 so，所以需要特别指定一下 abi

android {
    ...
    defaultConfig {
      ...
      ndk {
          abiFilters 'armeabi-v7a'
      }
    }
}

6.5 编写 CMakeLists

# For more information about using CMake with Android Studio, read the
# documentation: https://d.android.com/studio/projects/add-native-code.html
# Sets the minimum version of CMake required to build the native library.
cmake_minimum_required(VERSION 3.4.1)
# Creates and names a library, sets it as either STATIC
# or SHARED, and provides the relative paths to its source code.
# You can define multiple libraries, and CMake builds them for you.
# Gradle automatically packages shared libraries with your APK.
add_library( # Sets the name of the library.
             native-lib
             # Sets the library as a shared library.
             SHARED
             # Provides a relative path to your source file(s).
             src/main/cpp/native-lib.cpp )
add_library( avcodec-57
             SHARED
             IMPORTED )
set_target_properties( avcodec-57
                       PROPERTIES IMPORTED_LOCATION
                       ../../../../libs/armeabi-v7a/libavcodec-57.so )
add_library( avfilter-6
             SHARED
             IMPORTED )
set_target_properties( avfilter-6
                       PROPERTIES IMPORTED_LOCATION
                       ../../../../libs/armeabi-v7a/libavfilter-6.so )
add_library( avformat-57
             SHARED
             IMPORTED )
set_target_properties( avformat-57
                       PROPERTIES IMPORTED_LOCATION
                       ../../../../libs/armeabi-v7a/libavformat-57.so )
add_library( avutil-55
             SHARED
             IMPORTED )
set_target_properties( avutil-55
                       PROPERTIES IMPORTED_LOCATION
                       ../../../../libs/armeabi-v7a/libavutil-55.so )
add_library( swresample-2
             SHARED
             IMPORTED )
set_target_properties( swresample-2
                       PROPERTIES IMPORTED_LOCATION
                       ../../../../libs/armeabi-v7a/libswresample-2.so )
add_library( swscale-4
             SHARED
             IMPORTED )
set_target_properties( swscale-4
                       PROPERTIES IMPORTED_LOCATION
                       ../../../../libs/armeabi-v7a/libswscale-4.so )
include_directories( libs/include )
find_library( # Sets the name of the path variable.
              log-lib
              # Specifies the name of the NDK library that
              # you want CMake to locate.
              log )
# Specifies libraries CMake should link to your target library. You
# can link multiple libraries, such as libraries you define in this
# build script, prebuilt third-party libraries, or system libraries.
target_link_libraries( # Specifies the target library.
                       native-lib
                       avcodec-57
                       avfilter-6
                       avformat-57
                       avutil-55
                       swresample-2
                       swscale-4
                       # Links the target library to the log library
                       # included in the NDK.
                       ${log-lib} )

6.6 Java 引入 so 库

static {
    System.loadLibrary("native-lib");
    System.loadLibrary("avcodec-57");
    System.loadLibrary("avfilter-6");
    System.loadLibrary("avformat-57");
    System.loadLibrary("avutil-55");
    System.loadLibrary("swresample-2");
    System.loadLibrary("swscale-4");
}

最后运行测试下，即配置完成。

Zhenghui's World

Write the code, change the world