iOS 开发之编译ffmpeg 及报错解析
一、脚本编译
1. 编译Mac下可用 FFmpeg
编译Mac下可用 FFmpeg，主要是可以在mac中，使用 FFmpeg 进行操作视频等。
Homebrew介绍
简称brew，是Mac OSX上的软件包管理工具，能在Mac中方便的安装软件或者卸载软件。
Homebrew安装
打开终端执行
ruby -e "$(curl -fsSL[https://raw.githubusercontent.com/Homebrew/install/master/install)](https://links.jianshu.com/go?to=https%3A%2F%2Fraw.githubusercontent.com%2FHomebrew%2Finstall%2Fmaster%2Finstall)”)"
Homebrew命令使用
搜索软件：brew search 软件名， 如brew search wget
安装软件：brew install 软件名， 如brew install wget
卸载软件：brew remove 软件名，如brew remove wget
通过Homebrew 安装 FFmpeg
终端执行：执行 brew install ffmpeg --with-libvpx --with-libvorbis --with-ffplay
在终端中执行一下命令，等待安装完成即可：
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
安装好Homebrew，然后终端执行 "brew install ffmpeg"，等待完成即可。
执行结束，在终端中输入ffmpeg，验证是否安装成功。
image
2. 编译 iOS 下 FFmpeg
主要是用于iOS下可用的FFmpeg
手动编译FFmpeg网上有一些方法，但是稍显复杂而陈旧, 所以现在大部分都是使用FFmpeg-iOS-build-script.sh这个脚本，比较方便直接
FFmpeg-iOS-build-script 是一个外国人写的自动编译的脚本，脚本则会自动从github中把ffmpeg源码下到本地并开始编译出iOS可用的库，支持各种架构。
在进行编译之前，需要做一些准备工作安装必备文件：
2.1 安装 gas-preprocessor
后面运行 FFmpeg-iOS-build-script 这个自动编译脚本需要 gas-preprocessor .
安装步骤（依次执行下面命令）：
sudo git clone https://github.com/bigsen/gas-preprocessor.git /usr/local/bin/gas
sudo cp /usr/local/bin/gas/gas-preprocessor.pl /usr/local/bin/gas-preprocessor.pl
sudo chmod 777 /usr/local/bin/gas-preprocessor.pl
sudo rm -rf /usr/local/bin/gas/
2.2 安装 yams
yasm是汇编编译器，因为ffmpeg中为了提高效率用到了汇编指令，所以编译时需要安装
安装步骤（依次执行下面命令）：
curl http://www.tortall.net/projects/yasm/releases/yasm-1.2.0.tar.gz-o yasm-1.2.0.gz
tar-zxvf yasm-1.2.0.gz
cd yasm-1.2.0
./configure&&make-j4&&sudomakeinstall
二、 配置 FFmpeg 编译脚本
下载编译脚本
git clone https://github.com/kewlbear/FFmpeg-iOS-build-script.git
配置FFmpeg版本
当前使用的是4.3.1版本，不过最新版本已经更新到####6.0
官方地址：https://ffmpeg.org/download.html?aemtn=tg-on
注意：在使用最新版本的时候，可能会存在iOS版本的兼容性问题，后面会说到，例如 FFmpeg 6.0版本 iOS版本需要在 13.0以上才可以编译
根据需要编译出需要的库文件，修改配置 build-ffmpeg.sh 脚本里面 CONFIGURE_FLAGS 后面的内容，可用把很多不需要的东西，都禁止掉，这样编译出来的库就不会非常庞大
例如我们在编译最新版本的f fmpeg-6.0的时候，会报 audiotoolbox 存在错误的问题，我们只需要在CONFIGURE_FLAGS 后面字符串中加入： --disable-audiotoolbox 字符串就可以解决
image
配置选项参数
在ffmpeg源码目录下，终端执行 ./configure --help可用查看全部参数，下面简单列出部分参数
image
--disable-static ：// 不构建静态库[默认：关闭]
--enable-shared ：// 构建共享库
--enable-gpl ： // 允许使用GPL代码。
--enable-nonfree ：// 允许使用非免费代码。
--disable-doc ： // 不构造文档
--disable-avfilter ：// 禁止视频过滤器支持
--enable-small ： // 启用优化文件尺寸大小（牺牲速度）
--cross-compile ： // 使用交叉编译
--disable-hwaccels ：// 禁用所有硬件加速(本机不存在硬件加速器，所有不需要)
--disable-network ：// 禁用网络
--disable-ffmpeg --disable-ffplay --disable-ffprobe --disable-ffserver
// 禁止ffmpeg、ffplay、ffprobe、ffserver
--disable-avdevice --disable-avcodec --disable-avcore
// 禁止libavdevice、libavcodec、libavcore
--list-decoders ： // 显示所有可用的解码器
--list-encoders ： // 显示所有可用的编码器
--list-hwaccels ： // 显示所有可用的硬件加速器
--list-protocols ： // 显示所有可用的协议
--list-indevs ： // 显示所有可用的输入设备
--list-outdevs ： // 显示所有可用的输出设备
--list-filters ：// 显示所有可用的过滤器
--list-parsers ：// 显示所有的解析器
--list-bsfs ： // 显示所有可用的数据过滤器
--disable-encoder=NAME ： // 禁用XX编码器 | disables encoder NAME
--enable-encoder=NAME ： // 用XX编码器 | enables encoder NAME
--disable-decoders ： // 禁用所有解码器 | disables all decoders
--disable-decoder=NAME ： // 禁用XX解码器 | disables decoder NAME
--enable-decoder=NAME ： // 启用XX解码器 | enables decoder NAME
--disable-encoders ： // 禁用所有编码器 | disables all encoders
--disable-muxer=NAME ： // 禁用XX混音器 | disables muxer NAME
--enable-muxer=NAME ： // 启用XX混音器 | enables muxer NAME
--disable-muxers ： // 禁用所有混音器 | disables all muxers
--disable-demuxer=NAME ： // 禁用XX解轨器 | disables demuxer NAME
--enable-demuxer=NAME ： // 启用XX解轨器 | enables demuxer NAME
--disable-demuxers ： // 禁用所有解轨器 | disables all demuxers
--enable-parser=NAME ： // 启用XX剖析器 | enables parser NAME
--disable-parser=NAME ： // 禁用XX剖析器 | disables parser NAME
--disable-parsers ： // 禁用所有剖析器 | disa
运行脚本生成 FFmpeg：
./build-ffmpeg.sh
三、编译中存在的报错
1、FFmpeg-5.0以上编译，报audiotoolbox错误：
src/libavdevice/audiotoolbox.m:78:5: error: unknown type name 'AudioDeviceID'; did you mean 'AudioFileID'?
AudioDeviceID *devices;
^~~~~~~~~~~~~
AudioFileID
/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS16.2.sdk/System/Library/Frameworks/AudioToolbox.framework/Headers/AudioFile.h:197:35: note: 'AudioFileID' declared here
typedef struct OpaqueAudioFileID *AudioFileID;
^
src/libavdevice/audiotoolbox.m:84:5: error: use of undeclared identifier 'AudioObjectPropertyAddress'
AudioObjectPropertyAddress prop;
^
src/libavdevice/audiotoolbox.m:85:5: error: use of undeclared identifier 'prop'
prop.mSelector = kAudioHardwarePropertyDevices;
^
src/libavdevice/audiotoolbox.m:85:22: error: use of undeclared identifier 'kAudioHardwarePropertyDevices'
prop.mSelector = kAudioHardwarePropertyDevices;
^
src/libavdevice/audiotoolbox.m:86:5: error: use of undeclared identifier 'prop'
prop.mScope = kAudioObjectPropertyScopeGlobal;
^
src/libavdevice/audiotoolbox.m:86:22: error: use of undeclared identifier 'kAudioObjectPropertyScopeGlobal'
prop.mScope = kAudioObjectPropertyScopeGlobal;
^
src/libavdevice/audiotoolbox.m:87:5: error: use of undeclared identifier 'prop'
prop.mElement = kAudioObjectPropertyElementMaster;
^
src/libavdevice/audiotoolbox.m:87:22: error: use of undeclared identifier 'kAudioObjectPropertyElementMaster'; did you mean 'kAudioUnitProperty_ElementName'?
prop.mElement = kAudioObjectPropertyElementMaster;
^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
kAudioUnitProperty_ElementName
/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS16.2.sdk/System/Library/Frameworks/AudioToolbox.framework/Headers/AudioUnitProperties.h:900:2: note: 'kAudioUnitProperty_ElementName' declared here
kAudioUnitProperty_ElementName = 30,
^
src/libavdevice/audiotoolbox.m:88:11: error: implicit declaration of function 'AudioObjectGetPropertyDataSize' is invalid in C99 [-Werror,-Wimplicit-function-declaration]
err = AudioObjectGetPropertyDataSize(kAudioObjectSystemObject, &prop, 0, NULL, &data_size);
^
src/libavdevice/audiotoolbox.m:88:11: note: did you mean 'AudioQueueGetPropertySize'?
/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS16.2.sdk/System/Library/Frameworks/AudioToolbox.framework/Headers/AudioQueue.h:1458:1: note: 'AudioQueueGetPropertySize' declared here
AudioQueueGetPropertySize( AudioQueueRef inAQ,
^
src/libavdevice/audiotoolbox.m:88:42: error: use of undeclared identifier 'kAudioObjectSystemObject'
err = AudioObjectGetPropertyDataSize(kAudioObjectSystemObject, &prop, 0, NULL, &data_size);
^
src/libavdevice/audiotoolbox.m:88:69: error: use of undeclared identifier 'prop'
err = AudioObjectGetPropertyDataSize(kAudioObjectSystemObject, &prop, 0, NULL, &data_size);
^
src/libavdevice/audiotoolbox.m:92:38: error: use of undeclared identifier 'AudioDeviceID'
num_devices = data_size / sizeof(AudioDeviceID);
^
src/libavdevice/audiotoolbox.m:94:30: error: expected expression
devices = (AudioDeviceID*)(av_malloc(data_size));
^
src/libavdevice/audiotoolbox.m:94:16: error: use of undeclared identifier 'AudioDeviceID'
devices = (AudioDeviceID*)(av_malloc(data_size));
^
src/libavdevice/audiotoolbox.m:95:11: error: implicit declaration of function 'AudioObjectGetPropertyData' is invalid in C99 [-Werror,-Wimplicit-function-declaration]
err = AudioObjectGetPropertyData(kAudioObjectSystemObject, &prop, 0, NULL, &data_size, devices);
^
CC libavdevice/utils.o
src/libavdevice/audiotoolbox.m:95:11: note: did you mean 'AudioObjectGetPropertyDataSize'?
src/libavdevice/audiotoolbox.m:88:11: note: 'AudioObjectGetPropertyDataSize' declared here
err = AudioObjectGetPropertyDataSize(kAudioObjectSystemObject, &prop, 0, NULL, &data_size);
^
src/libavdevice/audiotoolbox.m:95:38: error: use of undeclared identifier 'kAudioObjectSystemObject'
err = AudioObjectGetPropertyData(kAudioObjectSystemObject, &prop, 0, NULL, &data_size, devices);
^
src/libavdevice/audiotoolbox.m:95:65: error: use of undeclared identifier 'prop'
err = AudioObjectGetPropertyData(kAudioObjectSystemObject, &prop, 0, NULL, &data_size, devices);
^
src/libavdevice/audiotoolbox.m:104:9: error: use of undeclared identifier 'prop'
prop.mScope = kAudioDevicePropertyScopeInput;
^
src/libavdevice/audiotoolbox.m:104:23: error: use of undeclared identifier 'kAudioDevicePropertyScopeInput'
prop.mScope = kAudioDevicePropertyScopeInput;
^
fatal error: too many errors emitted, stopping now [-ferror-limit=]
20 errors generated.
make: *** [libavdevice/audiotoolbox.o] Error 1
make: *** Waiting for unfinished jobs....
分析：
audiotoolbox 主要是对音频的硬编解码起到作用，因为技术更新太快，f fmpeg中并没有写向下兼容的问题，导致在iOS版本较低时编译会存在一些无法设备的属性、变量以及方法，所以导致编译报错，所以这里的解决方案是，直接禁止编译 audiotoolbox。
解决方案：
所以我们只需要 "build-ffmpeg.sh"中的在CONFIGURE_FLAGS 后面字符串中加入： --disable-audiotoolbox 字符串就可以解决
2、FFmpeg-4.0 到 FFmpeg-5.0以下编译，报“librist/librist.h”错：
src/libavformat/librist.c:36:10: fatal error: 'librist/librist.h' file not found
#include <librist/librist.h>
分析：
因为在此版本后引入librist，但是编译脚本中 iOS最低支持的版本是 8.0
DEPLOYMENT_TARGET="8.0"
当改掉 DEPLOYMENT_TARGET="9.0"后此问题变被解决，具体原因不知，猜测是iOS 9.0后引入的 librist库
解决方案：
所以我们只需要在 "build-ffmpeg.sh"中将 DEPLOYMENT_TARGET="8.0" 改为
DEPLOYMENT_TARGET="9.0" 或以上变可解决此问题
3、FFmpeg-5.0以上编译， Target 版本 小于 13.0 时报错
xcrun -sdk macosx metal src/libavfilter/metal/vf_yadif_videotoolbox.metal -o libavfilter/metal/vf_yadif_videotoolbox.metal.air
CC libavfilter/motion_estimation.o
src/libavfilter/metal/utils.m:35:21: error: 'supportsFamily:' is only available on iOS 13.0 or newer [-Werror,-Wunguarded-availability-new]
if ([device supportsFamily:MTLGPUFamilyCommon3]) {
^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS16.2.sdk/System/Library/Frameworks/Metal.framework/Headers/MTLDevice.h:744:1: note: 'supportsFamily:' has been marked as being introduced in iOS 13.0 here, but the deployment target is iOS 9.0.0
- (BOOL)supportsFamily:(MTLGPUFamily)gpuFamily API_AVAILABLE(macos(10.15), ios(13.0));
^
src/libavfilter/metal/utils.m:35:21: note: enclose 'supportsFamily:' in an @available check to silence this warning
if ([device supportsFamily:MTLGPUFamilyCommon3]) {
^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
src/libavfilter/metal/utils.m:35:36: error: 'MTLGPUFamilyCommon3' is only available on iOS 13.0 or newer [-Werror,-Wunguarded-availability-new]
if ([device supportsFamily:MTLGPUFamilyCommon3]) {
^~~~~~~~~~~~~~~~~~~
/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS16.2.sdk/System/Library/Frameworks/Metal.framework/Headers/MTLDevice.h:154:28: note: 'MTLGPUFamily' has been marked as being introduced in iOS 13.0 here, but the deployment target is iOS 9.0.0
typedef NS_ENUM(NSInteger, MTLGPUFamily)
分析：
这个问题很简单，就是在 FFmpeg-5.0以上中使用 “supportsFamily” ，而“supportsFamily” 只有在 iOS13.0以后才支持，因此低于 iOS13.0编译会报错
解决方案：
所以我们只需要在 "build-ffmpeg.sh"中将 DEPLOYMENT_TARGET改为
="13.0" 或以上变可解决此问题
4、FFmpeg-5.0以上编译，iOS 版本设置为 13.0及以上 armv7、i386编译报错
building armv7...
xcrun -sdk iphoneos clang is unable to create an executable file.
C compiler test failed.
分析：
因为iOS 13.0以后不再使用armv7架构，所以在DEPLOYMENT_TARGET="13.0"
编译 armv7架构会报错。
解决方案：
在 "build-ffmpeg.sh"脚本中将
ARCHS="arm64 armv7 x86_64 i386 " 的 armv7 去掉变可解决此问题
building i386...
xcrun -sdk iphonesimulator clang is unable to create an executable file.
C compiler test failed.
分析：
因为iOS 13.0以后不再支持i386架构，所以在DEPLOYMENT_TARGET="13.0"
编译 i386架构会报错。
解决方案：
在 "build-ffmpeg.sh"脚本中将
ARCHS="arm64 armv7 x86_64 i386 " 的 i386 去掉变可解决此问题
网友评论