MRFFToolChain Build Shell

What's MRFFToolChain?

MRFFToolChain products was built for ijkplayer : https://github.com/debugly/ijkplayer.

At present MRFFToolChain contained ass、bluray、dav1d、dvdread、ffmpeg、freetype、fribidi、harfbuzz、openssl、opus、unibreak、uavs3d、smb2.

Supported Plat

Deprecations

MRFFToolChain will remove bitcode support about 2025.01.01

Starting with Xcode 14, bitcode is no longer required for watchOS and tvOS applications, and the App Store no longer accepts bitcode submissions from Xcode 14.

Xcode no longer builds bitcode by default and generates a warning message if a project explicitly enables bitcode: “Building with bitcode is deprecated. Please update your project and/or target settings to disable bitcode.” The capability to build with bitcode will be removed in a future Xcode release. IPAs that contain bitcode will have the bitcode stripped before being submitted to the App Store. Debug symbols can only be downloaded from App Store Connect / TestFlight for existing bitcode submissions and are no longer available for submissions made with Xcode 14. (86118779)

https://developer.apple.com/documentation/xcode-release-notes/xcode-14-release-notes#Deprecations

Denpendency

Harfbuzz: freetype Ass: harfbuzz,fribidi,unibreak FFmpeg: openssl,opus,dav1d,dvdread,uavs3d

Tips:

1、FFmpeg is not denpendent on Ass.
2、ijkplayer is denpendent on FFmpeg and Ass.
3、when install pre-compiled lib, will containes it's denpendencies.

Folder structure

├── README.md
├── build       #编译目录
│   ├── extra   #源码仓库
│   ├── pre     #下载的预编译库
│   ├── product #编译产物
│   └── src     #构建时源码仓库
├── configs     #三方库配置信息
│   ├── default.sh
│   ├── ffconfig #FFmpeg功能裁剪选项
│   ├── libs     #三方库具体配置，包括库名，git仓库地址等信息
│   └── meson-crossfiles
├── do-compile   #三方库编译具体过程
│   ├── any.sh   #三方库编译通用过程
│   ├── ass.sh
│   ├── bluray.sh
│   ├── dav1d.sh
│   ├── dvdread.sh
│   ├── ffmpeg.sh
│   ├── freetype.sh
│   ├── fribidi.sh
│   ├── harfbuzz.sh
│   ├── libyuv.sh
│   ├── main.sh   #三方库编译入口
│   ├── openssl.sh
│   ├── opus.sh
│   ├── smb2.sh
│   ├── uavs3d.sh
│   └── unibreak.sh
├── do-init       #初始化三方库仓库
│   ├── copy-local-repo.sh
│   ├── init-repo.sh
│   └── main.sh
├── do-install    #下载安装预编译的三方库
│   ├── install-pre-lib.sh
│   ├── install-pre-xcf.sh
│   └── main.sh
├── main.sh      #脚本入口
├── patches      #给三方库打的补丁
│   ├── bluray
│   ├── ffmpeg -> ffmpeg-n6.1
│   ├── ffmpeg-n4.0
│   ├── ffmpeg-n5.1
│   ├── ffmpeg-n6.1
│   └── ffmpeg-release-5.1
└── tools
    ├── env_assert.sh
    ├── export-plat-env.sh
    └── ios.toolchain.cmake

Download/Install Pre-compiled libs

直接从 github 下载我预编译好的库，这种方式可节省大量时间。

预编译库已经将 patches 目录下的补丁全部打上了。

安装方法：

#查看帮助是个好习惯
./main.sh install -h
# 使用方式随便举例：
./main.sh install -p macos -l ffmpeg
./main.sh install -p ios -l 'ass ffmpeg'
./main.sh install -p tvos -l all

Compile by yourself

Init lib repos

不要浪费自己的时间去编译这些库，除非你修改了源码！ 直接下载我白嫖 github 预先编译好的库不好么！

脚本参数比较灵活，可根据需要搭配使用，常用方式举例：

#查看帮助是个好习惯
./main.sh init -h
#准备 iOS 平台源码所有库的源码
./main.sh init -p ios -l all
#准备 iOS 平台x86架构下所有库的源码
./main.sh init -p ios -l all -a x86_64_simulator
#准备 macOS 平台源码所有库的源码
./main.sh init -p macos -l all
#准备 ios 平台的某些库的源码
./main.sh init -p ios -l "openssl ffmpeg"

Compile

查看帮助是个好习惯

./main.sh compile -h
# 根据帮助可知 -p 参数指定平台；-c 参数指定行为，比如：build是编译，rebuild是重编等; -l 指定要编译的库；-a 指定 cpu 架构。

使用方式随便举例：

#比如编译 ios 平台所有依赖库
./main.sh compile -c build -p ios -l all
#比如编译 ios 平台 arm64 架构下的 libass 库
./main.sh compile -c build -p ios -a arm64 -l ass

脚本对于这些参数的顺序没有要求，可以随意摆放。

Support Mirror

如果 github 上的仓库克隆较慢，或者需要使用内网私有仓库，可在执行编译脚本前声明对应的环境变量！

Tips

• 可下载预编译的 xcframework 库，只需要在 install 时加上 -f 参数
• 初始化仓库时，可跳过拉取远端到本地，只需要在 init 时加上 -b 参数
• 初始化仓库时，可跳过应用 FFmpeg 的补丁，只需要在 init 时加上 -k 参数
• 目前 FFmpeg 使用的是 module-full.sh 配置选项，所以包体积略大

Donate

编译三方库很费时间，本人想为开源社区贡献一份微薄的力量，因此将 debugly/ijkplayer 依赖的三方库，全部预编成静态库和 xcframework 供大家使用。

如果您想要为开源社区贡献一份力量，请买杯咖啡给我提提神儿。

感谢以下朋友对 debugly/MRFFToolChainBuildShell 的支持：

• 海阔天也空
• 小猪猪
• 1996GJ