要在 iOS 上做影音處理,第一步一定是把 FFmpeg 的原始碼交叉編譯成靜態庫。編譯本身不算難,真正容易卡住的是 configure 那一長串參數——選錯就會產出兩百多 MB 的庫,塞進 App 直接把包體撐爆。
./configure \ --prefix=../i386 \ --disable-ffmpeg --disable-ffplay --disable-ffprobe --disable-ffserver \ --enable-avresample \ --enable-cross-compile \ --sysroot=/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneSimulator.platform/Developer/SDKs/iPhoneSimulator7.0.sdk \ --target-os=darwin \ --cc=/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/clang \ --extra-cflags="-arch i386 -miphoneos-version-min=7.0" \ --extra-ldflags="-arch i386 -isysroot /Applications/Xcode.app/Contents/Developer/Platforms/iPhoneSimulator.platform/Developer/SDKs/iPhoneSimulator7.0.sdk -miphoneos-version-min=7.0" \ --arch=i386 --cpu=i386 \ --enable-pic --disable-asm \ --enable-decoder=h264 --enable-decoder=rv40
sudo make && sudo make install
打開終端機,切到解壓後的 FFmpeg 目錄,依序執行上面兩段。第一段只做環境檢查與設定,會產生 config.h 等檔案;第二段才真的開始編譯,畫面上會飛快捲過一堆以 cc 開頭的指令,最後把 include 與 lib 兩個資料夾產生出來。
第一次成功之後我發現輸出的靜態庫竟有兩百多 MB,於是回頭研究每個參數的意義,想辦法把用不到的模組排除掉。
(1)參數之間必須有空格
這是最蠢也最常犯的錯。把 --disable-ffmpeg --disable-ffplay 誤貼成 --disable-ffmpeg--disable-ffplay,編譯時會抱怨「不認識 --disable-ffmpeg--disable-ffplay」這個選項,而你還以為是自己其中一段打錯字——其實系統把它當成了一整串。
(2)--prefix
指定編譯成果要放哪裡。自己開一個資料夾再拖進去即可。
(3)--disable-xxx / --enable-xxx
這一段決定了最終庫裡會有多少東西。如果只需要 h264 解碼,最有效率的做法是先全關再單獨開:
--disable-decoders --enable-decoder=h264
第一行把所有解碼器關掉,第二行再把要的那一個打開,庫的大小會立刻瘦一大圈。想知道有哪些可選項目:
./configure --list-decoders ./configure --list-encoders ./configure --list-demuxers ./configure --list-muxers ./configure --list-parsers ./configure --list-protocols ./configure --list-filters ./configure --help
至於到底該關掉哪些、留下哪些,就得對 FFmpeg 各元件在影音處理流程中扮演的角色有點概念了——解封裝(demuxer)、解碼(decoder)、濾鏡(filter)、協定(protocol)缺一不可,關錯會在執行期才炸。
(4)--enable-cross-compile 與 --target-os=darwin
前者允許交叉編譯,後者指定目標系統為 Apple 的 Darwin 核心。
(5)--sysroot
指向要對應的 iOS SDK 路徑。真機與模擬器的 SDK 路徑不同,這個參數也要跟著換,這正是為什麼 FFmpeg for iOS 通常要編譯兩次(甚至加上 arm64 共三次),最後再用 lipo 合併成 fat library。
(6)--cc
編譯器路徑。Xcode 5 之後預設已經是 clang。
(7)--arch 與 --cpu
指定架構與 CPU 型號。模擬器是 i386(現在則是 x86_64 或 arm64 模擬器),舊款 iPhone 是 --arch=arm --cpu=cortex-a8,iPhone 5s 之後是 arm64。
(8)--disable-static
加上它會產出動態庫。iOS 上不允許這類第三方動態庫,因此一般保持靜態。
如果編譯中途失敗,可以打開 FFmpeg 目錄下的 config.log,裡面有更詳細的錯誤資訊,通常一眼就能看出是哪個 header 找不到。
編譯完成會得到 include 與 lib 兩個資料夾,把它們拖進 Xcode 專案,接著設定 Header Search Paths 與 Library Search Paths,否則會出現「xxx.h 檔案不存在」的錯誤。路徑都設好之後如果還抱怨某些符號缺失,通常是兩種原因之一:忘了加入必要的系統框架或函式庫(例如 libz、libbz2、AVFoundation、CoreMedia),或者編譯時把某個元件 disable 掉了。回到需求本身釐清需要哪些能力,再重新編一次即可。
這套流程的觀念完全沒變,但細節已經不同:Xcode 早已不再附在 /Applications/Xcode.app 這個固定路徑下的舊結構,建議用 xcrun --sdk iphonesimulator --show-sdk-path 取得 sysroot,用 clang -arch arm64 直接指定架構,並改用 --enable-pic 搭配 make -j 縮短編譯時間。真機與模擬器要分別編,最後用 lipo -create 合併;若專案要上 App Store,還得注意不要把模擬器 slice 一起打包上傳。