ijkplayer 是 bilibili 開源的一款優(yōu)秀的播放器, 基于 FFmpeg, 支持 iOS/Android, 點(diǎn)播/直播, 以及多種編碼. 官方并不直接提供 framework 框架包, 這樣大家可以根據(jù)需要選擇配置, 自己編譯并打包. 但是也讓很多第一次使用的小伙伴一臉懵逼, 并且默認(rèn)配置只支持 http, 如果想播放 https 鏈接的視頻, 那么需要做額外的配置
本文為 iOS 的編譯打包過程, 環(huán)境為 Mac + Xcode
準(zhǔn)備工作
安裝 homebrew, git, yasm. (如果已經(jīng)安裝好可以跳過, 不清楚的再來一遍也無妨)
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
brew install git
brew install yasm
獲取 ijkplayer 源碼
在一個(gè)合適的位置新建一個(gè)文件夾, 假設(shè)為桌面, 文件夾名為 ijkplayer
.
打開終端, 輸入下面的指令
# 進(jìn)入到剛剛新建的文件夾內(nèi)
cd ~/Desktop/ijkplayer/
# 獲取ijkplayer源碼
git clone https://github.com/Bilibili/ijkplayer.git ijkplayer-ios
# 進(jìn)入源碼目錄
cd ijkplayer-ios
# 切換分支 (目前為k0.8.8, 可以自行去GitHub查看最新版本號(hào))
git checkout -B latest k0.8.8
配置編解碼器格式支持
默認(rèn)為最少支持, 如果足夠你使用, 可以跳過這一步. 否則可以改為以下配置:
-
module-default.sh
更多的編解碼器/格式 -
module-lite-hevc.sh
較少的編解碼器/格式(包括hevc) -
module-lite.sh
較少的編解碼器/格式(默認(rèn)情況)
# 進(jìn)入 config 目錄
cd config
# 刪除當(dāng)前的 module.sh 文件
rm module.sh
# 可根據(jù)需要替換為`module-default.sh`, `module-lite-hevc.sh`, `module-lite.sh`
# 創(chuàng)建軟鏈接 module.sh 指向 module-lite-hevc.sh
ln -s module-lite-hevc.sh module.sh
cd ..
cd ios
sh compile-ffmpeg.sh clean
獲取 ffmpeg 并初始化
cd ..
./init-ios.sh
添加 https 支持
最后會(huì)生成支持 https 的靜態(tài)文件 libcrypto.a
和 libssl.a
, 如果不需要可以跳過這一步
# 獲取 openssl 并初始化
./init-ios-openssl.sh
cd ios
# 在模塊文件中添加一行配置 以啟用 openssl 組件
echo 'export COMMON_FF_CFG_FLAGS="$COMMON_FF_CFG_FLAGS --enable-openssl"' >> ../config/module.sh
./compile-ffmpeg.sh clean
編譯
# 如果下一步提示錯(cuò)誤`xcrun: error: SDK "iphoneos" cannot be located`, 請(qǐng)執(zhí)行`sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer/`, 再重新執(zhí)行下一步
# 編譯openssl, 如果不需要https可以跳過這一步
./compile-openssl.sh all
# 編譯ffmpeg
./compile-ffmpeg.sh all
ps: 如果提示錯(cuò)誤:
./libavutil/arm/asm.S:50:9: error: unknown directive
.arch armv7-a
^
make: *** [libavcodec/arm/aacpsdsp_neon.o] Error 1
最新的 Xcode 已經(jīng)弱化了對(duì) 32 位的支持, 解決方法:
在 compile-ffmpeg.sh
中刪除 armv7
, 修改如:
FF_ALL_ARCHS_IOS8_SDK="arm64 i386 x86_64"
再重新執(zhí)行出現(xiàn)錯(cuò)誤的命令: ./compile-ffmpeg.sh all
打開 IJKMediaPlayer 項(xiàng)目
用命令:
open IJKMediaPlayer/IJKMediaPlayer.xcodeproj
或者手動(dòng)用 Xcode 打開 ios 目錄下的 IJKMediaPlayer 項(xiàng)目.
添加 openssl 相關(guān)包以支持 https
如果不使用 https, 可以跳過此步, 直接開始打包 framwork
如果使用 https, 那么需要手動(dòng)給 IJKMediaFramework 添加 libcrypto.a
和 libssl.a
文件, 默認(rèn)不會(huì)添加
ps: 這兩個(gè)依賴庫(kù)的目錄為: ijkplayer-ios/ios/build/universal/lib, 只有進(jìn)行了上面跟 openssl 相關(guān)的操作, 才會(huì)在這個(gè)目錄下有生成 libcrypto.a
和 libssl.a

打包 framwork
大家會(huì)發(fā)現(xiàn)除了 IJKMediaFramework
這個(gè) target, 還有一個(gè)叫 IJKMediaFrameworkWithSSL
, 但是不推薦使用這個(gè), 因?yàn)榇蟛糠只?ijkplayer 的第三方框架都是使用的前者, 你把后者導(dǎo)入項(xiàng)目還是會(huì)報(bào)找不到包的錯(cuò)誤, 就算你要支持 https 也推薦使用前者, 然后按照上一步添加 openssl 即可支持
-
配置 Release 模式如果下圖
WX20180408-234722@2x.png
WX20180408-234922@2x.png -
打包真機(jī) framework
選擇你連接的手機(jī)或者
Generic iOS Device
WX20180408-235726@2x.png如圖操作,然后按鍵
command+b
編譯即可如果之前的步驟刪除了
compile-ffmpeg.sh
中armv7
, 這里會(huì)報(bào)錯(cuò), 我們直接注釋掉就好WX20180408-235314@2x.png
WX20180408-235507@2x.png -
打包模擬器 framework
WX20180408-235921@2x.png如圖操作,然后
command+b
編譯即可 -
合并 framework
如果只需要真機(jī)運(yùn)行或者模擬器運(yùn)行, 可以不用合并, 直接找到對(duì)應(yīng)的 framework 導(dǎo)入項(xiàng)目即可; 一般我們?yōu)榱朔奖銜?huì)合并 framework, 這樣就同時(shí)支持模擬器和真機(jī)運(yùn)行.
先找到生成 framework 的目錄:
WX20180409-001503@2x.png
WX20180409-001745@2x.png準(zhǔn)備合并:
打開終端, 先
cd
到Products
目錄下然后執(zhí)行:
lipo -create 真機(jī)framework路徑 模擬器framework路徑 -output 合并的文件路徑
lipo -create Release-iphoneos/IJKMediaFramework.framework/IJKMediaFramework Release-iphonesimulator/IJKMediaFramework.framework/IJKMediaFramework -output IJKMediaFramework
合并完成:
可以看到這里生成了一個(gè)大概兩倍大小的文件, 將生成的
IJKMediaFramework
文件替換掉真機(jī)framework
中的IJKMediaFramework
文件,然后這個(gè)替換掉文件的真機(jī)framework
就是我們需要的通用的framework
了。WX20180409-002747@2x.png
WX20180409-003815@2x.png
集成 framework 到項(xiàng)目中
-
導(dǎo)入 framework
直接將
IJKMediaFramework.framework
拖入到工程中即可注意記得勾選
Copy items if needed
和 對(duì)應(yīng)的target
-
添加下列依賴到工程
-
libc++.tbd
( 編譯器選 gcc 的請(qǐng)導(dǎo)入libstdc++.tbd
) libz.tbd
libbz2.tbd
AudioToolbox.framework
UIKit.framework
CoreGraphics.framework
AVFoundation.framework
CoreMedia.framework
CoreVideo.framework
MediaPlayer.framework
MobileCoreServices.framework
OpenGLES.framework
QuartzCore.framework
VideoToolbox.framework
-
導(dǎo)入 ijkplayer 頭文件運(yùn)行一下項(xiàng)目, 如果遇到了類似這樣的錯(cuò)誤:

可能是因?yàn)閷?dǎo)入的依賴庫(kù)不全, 比如缺少 libc++.tbd, 請(qǐng)?jiān)俅螌?duì)照添加好所有的依賴庫(kù):
