ijkplayer 的編譯、打包 framework 和 https 支援

ijkplayer 是 bilibili 開源的一款優秀的播放器, 基於 FFmpeg, 支援 iOS/Android, 點播/直播, 以及多種編碼. 官方並不直接提供 framework 框架包, 這樣大家可以根據需要選擇配置, 自己編譯並打包. 但是也讓很多第一次使用的小夥伴一臉懵逼, 並且預設配置只支援 http, 如果想播放 https 連結的視訊, 那麼需要做額外的配置

本文為 iOS 的編譯打包過程, 環境為 Mac + Xcode

準備工作

安裝 homebrew, git, yasm. (如果已經安裝好可以跳過, 不清楚的再來一遍也無妨)

ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
brew install git
brew install yasm
複製程式碼

獲取 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
複製程式碼

配置編解碼器格式支援

預設為最少支援, 如果足夠你使用, 可以跳過這一步. 否則可以改為以下配置:

• 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.sh
ln -s module-lite-hevc.sh module.sh

cd ..
cd ios
sh compile-ffmpeg.sh clean
複製程式碼

獲取 ffmpeg 並初始化

cd ..
./init-ios.sh
複製程式碼

新增 https 支援

最後會生成支援 https 的靜態檔案 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
複製程式碼

編譯

# 如果下一步提示錯誤`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 , 修改如: FF_ALL_ARCHS_IOS8_SDK="arm64 i386 x86_64" 再重新執行出現錯誤的命令: ./compile-ffmpeg.sh all

開啟 IJKMediaPlayer 專案

用命令:

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

打包 framwork

大家會發現除了 IJKMediaFramework 這個 target, 還有一個叫 IJKMediaFrameworkWithSSL, 但是不推薦使用這個, 因為大部分基於 ijkplayer 的第三方框架都是使用的前者, 你把後者匯入專案還是會報找不到包的錯誤, 就算你要支援 https 也推薦使用前者, 然後按照上一步新增 openssl 即可支援

1. 配置 Release 模式如果下圖

   

   

2. 打包真機 framework

   選擇你連線的手機或者 Generic iOS Device

   

   如圖操作，然後按鍵 command+b 編譯即可

   如果之前的步驟刪除了 compile-ffmpeg.sh 中 armv7, 這裡會報錯, 我們直接註釋掉就好

   

   

3. 打包模擬器 framework

   

   如圖操作，然後 command+b 編譯即可

4. 合併 framework

   如果只需要真機執行或者模擬器執行, 可以不用合併, 直接找到對應的 framework 匯入專案即可; 一般我們為了方便會合並 framework, 這樣就同時支援模擬器和真機執行.

   先找到生成 framework 的目錄:

   

   

   準備合併:

   開啟終端, 先 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 了。

   

   

整合 framework 到專案中

• 匯入 framework

  直接將 IJKMediaFramework.framework 拖入到工程中即可

  注意記得勾選 Copy items if needed 和 對應的 target

• 新增下列依賴到工程

  1. libc++.tbd ( 編譯器選 gcc 的請匯入 libstdc++.tbd )
  2. libz.tbd
  3. libbz2.tbd
  4. AudioToolbox.framework
  5. UIKit.framework
  6. CoreGraphics.framework
  7. AVFoundation.framework
  8. CoreMedia.framework
  9. CoreVideo.framework
  10. MediaPlayer.framework
  11. MobileCoreServices.framework
  12. OpenGLES.framework
  13. QuartzCore.framework
  14. VideoToolbox.framework

匯入 ijkplayer 標頭檔案執行一下專案, 如果遇到了類似這樣的錯誤:

可能是因為匯入的依賴庫不全, 比如缺少 libc++.tbd, 請再次對照新增好所有的依賴庫: