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, 请再次对照添加好全部的依赖库: