2023 最新iOS 开发之编译ffmpeg 及报错解析

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 去掉变可解决此问题

最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 202,802评论 5赞 476
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 85,109评论 2赞 379
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 149,683评论 0赞 335
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 54,458评论 1赞 273
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 63,452评论 5赞 364
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 48,505评论 1赞 281
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 37,901评论 3赞 395
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 36,550评论 0赞 256
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 40,763评论 1赞 296
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,556评论 2赞 319
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,629评论 1赞 329
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 33,330评论 4赞 318
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 38,898评论 3赞 307
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,897评论 0赞 19
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,140评论 1赞 259
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 42,807评论 2赞 349
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 42,339评论 2赞 342

推荐阅读更多精彩内容