1.準備工作
安裝 homebrew, git, yasm. (如果已經安裝好可以跳過, 不清楚的再來一遍也無妨)
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
brew install git
brew install yasm
2.獲取 ijkplayer 源碼
在一個合適的位置新建一個文件夾, 假設為桌面, 文件夾名為ijkplayer.
打開終端, 輸入下面的指令
# 進入到剛剛新建的文件夾內cd ~/Desktop/ijkplayer/# 獲取ijkplayer源碼git clone https://github.com/Bilibili/ijkplayer.git ijkplayer-ios# 進入源碼目錄cd ijkplayer-ios# 切換分支 (目前為k0.8.8, 可以自行去GitHub查看最新版本號)git checkout -B latest k0.8.8
3.配置編解碼器格式支持
默認為最少支持, 如果足夠你使用, 可以跳過這一步. 否則可以改為以下配置:
module-default.sh更多的編解碼器/格式
module-lite-hevc.sh較少的編解碼器/格式(包括hevc)
module-lite.sh較少的編解碼器/格式(默認情況)
# 進入 config 目錄cd config# 刪除當前的 module.sh 文件rm module.sh# 可根據需要替換為`module-default.sh`, `module-lite-hevc.sh`, `module-lite.sh`# 創建軟鏈接 module.sh 指向 module-lite-hevc.shln -s module-lite-hevc.sh module.shcd ..cd iossh compile-ffmpeg.sh clean
4.獲取 ffmpeg 并初始化
cd .../init-ios.sh
5.添加 https 支持
最后會生成支持 https 的靜態文件libcrypto.a和libssl.a, 如果不需要可以跳過這一步
# 獲取 openssl 并初始化./init-ios-openssl.shcd ios# 在模塊文件中添加一行配置 以啟用 openssl 組件echo 'export COMMON_FF_CFG_FLAGS="$COMMON_FF_CFG_FLAGS --enable-openssl"' >> ../config/module.sh./compile-ffmpeg.sh clean
6.編譯
# 如果下一步提示錯誤`xcrun: error: SDK "iphoneos" cannot be located`, 請執行`sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer/`, 再重新執行下一步# 編譯openssl, 如果不需要https可以跳過這一步./compile-openssl.sh all# 編譯ffmpeg./compile-ffmpeg.sh all
ps: 如果提示錯誤:
./libavutil/arm/asm.S:50:9: error: unknown directive? ? ? ? .arch armv7-a? ? ? ? ^make: *** [libavcodec/arm/aacpsdsp_neon.o] Error 1
最新的 Xcode 已經弱化了對 32 位的支持, 解決方法:
在compile-ffmpeg.sh中刪除armv7, 修改如:
需要把compile-ffmpeg.sh中的armv7去掉之后再次執行./compile-ffmpeg.sh clean,./compile-ffmpeg.sh all
第24行 改為: FF_ALL_ARCHS_IOS8_SDK="arm64 i386 x86_64"?
第120行 改為: if [ "$FF_TARGET" = "armv7s" -o "$FF_TARGET" = "arm64" ]; then?
第159行 改為: echo " compile-ffmpeg.sh arm64|i386|x86_64"?
因為之前沒有編譯armv7的版本,真機編譯的時候可能會出現'armv7/avconfig.h' file not found和'armv7/config.h' file not found錯誤。都需要把avconfig.h和config.h中的include "armv7/config.h"和include "armv7/avconfig.h"注釋掉。
armv7/avconfig.h文件在xcode中找不到可以到ijkplayer-ios/ios/build/universal/include/libavutil/avconfig.h找,或者再編譯后出現的build文件夾中搜索。
用命令:
open IJKMediaPlayer/IJKMediaPlayer.xcodeproj
或者手動用 Xcode 打開 ios 目錄下的 IJKMediaPlayer 項目.
添加 openssl 相關包以支持 https
如果不使用 https, 可以跳過此步, 直接開始打包 framwork
如果使用 https, 那么需要手動給 IJKMediaFramework 添加libcrypto.a和libssl.a文件, 默認不會添加
ps: 這兩個依賴庫的目錄為: ijkplayer-ios/ios/build/universal/lib, 只有進行了上面跟 openssl 相關的操作, 才會在這個目錄下有生成libcrypto.a和libssl.a
7.打包 framwork
1.Xcode12適配The linked library is missing one or more architectures required by this target問題:
解決辦法:在Target-Build Settings-Excluded Architectures中添加以下代碼
EXCLUDED_ARCHS__EFFECTIVE_PLATFORM_SUFFIX_simulator__NATIVE_ARCH_64_BIT_x86_64=arm64 arm64e armv7 armv7s armv6 armv8 EXCLUDED_ARCHS=$(inherited)$(EXCLUDED_ARCHS__EFFECTIVE_PLATFORM_SUFFIX_$(EFFECTIVE_PLATFORM_SUFFIX)__NATIVE_ARCH_64_BIT_$(NATIVE_ARCH_64_BIT))
2.打包framwork時可能會出現無法合成真機和模擬器framework的問題:
?/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/lipo: Release-iphoneos/IJKMediaFramework.framework/IJKMediaFramework and Release-iphonesimulator/IJKMediaFramework.framework/IJKMediaFramework have the same architectures (arm64) and can't be in the same fat output file
解決辦法:
Build Settings -> Excluded Architectures里按照這樣設置一下,再編譯合并就不會報錯了。
大家會發現除了IJKMediaFramework這個 target, 還有一個叫IJKMediaFrameworkWithSSL, 但是不推薦使用這個, 因為大部分基于 ijkplayer 的第三方框架都是使用的前者, 你把后者導入項目還是會報找不到包的錯誤, 就算你要支持 https 也推薦使用前者, 然后按照上一步添加 openssl 即可支持
配置 Release 模式如果下圖
WX20180408-234722@2x.png
WX20180408-234922@2x.png
打包真機 framework
選擇你連接的手機或者Generic iOS Device
WX20180408-235726@2x.png
如圖操作,然后按鍵command+b編譯即可
如果之前的步驟刪除了compile-ffmpeg.sh中armv7, 這里會報錯, 我們直接注釋掉就好
WX20180408-235314@2x.png
WX20180408-235507@2x.png
打包模擬器 framework
WX20180408-235921@2x.png
如圖操作,然后command+b編譯即可
合并 framework
如果只需要真機運行或者模擬器運行, 可以不用合并, 直接找到對應的 framework 導入項目即可; 一般我們為了方便會合并 framework, 這樣就同時支持模擬器和真機運行.
先找到生成 framework 的目錄:
WX20180409-001503@2x.png
WX20180409-001745@2x.png
準備合并:
打開終端, 先cd到Products目錄下
然后執行:lipo -create 真機framework路徑 模擬器framework路徑 -output 合并的文件路徑
lipo -create Release-iphoneos/IJKMediaFramework.framework/IJKMediaFramework Release-iphonesimulator/IJKMediaFramework.framework/IJKMediaFramework -output IJKMediaFramework
合并完成:
可以看到這里生成了一個大概兩倍大小的文件, 將生成的IJKMediaFramework文件替換掉真機framework中的IJKMediaFramework文件,然后這個替換掉文件的真機framework就是我們需要的通用的framework了。
WX20180409-002747@2x.png
WX20180409-003815@2x.png
集成 framework 到項目中
導入 framework
直接將IJKMediaFramework.framework拖入到工程中即可
注意記得勾選Copy items if needed和 對應的target
添加下列依賴到工程
libc++.tbd( 編譯器選 gcc 的請導入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
導入 ijkplayer 頭文件運行一下項目, 如果遇到了類似這樣的錯誤:
WX20180409-005101@2x.png
可能是因為導入的依賴庫不全, 比如缺少 libc++.tbd, 請再次對照添加好所有的依賴庫: