使用 jsdelivr 加速 cocoapod 库

iOS 开发时, cocoapods(后简称 pod) 是很常用的工具

我们偶尔也会自己开发 pod 库并上传到 pod 上

pod 的源码支持多种来源, 本地 path git http 等

一般来说, 如果是纯开源库, 我们直接把源码上传到 github , 然后使用 git 依赖即可

但是这有一个问题, github 的速度在中国大陆并不快, 我们有没有办法加速它呢?

这时候经过搜索, jsdelivr 出现在了搜索引擎里, 号称国内外都可用的cdn, 我用wget测试了一下, 10M/s的速度还是能保持的

jsdelivr 介绍

这东西本身最初目的是为了加速 js/css 的访问

但是, 上面也说了, 支持"任何"在 github 上的仓库, 很好, 我就喜欢这样的东西

版本号的坑

文档上说支持所有 ref 作为版本号, 然而不是, 我这里测试只支持 tag/release

包体大小限制

我的目的是为了给 flutter_ijkplayer 的 iOS 仓库找一个下载地址, ijkplayer 的 iOS 部分很大, 我打包完有 150M, 用了 xz 压缩方案让包变成了 35M

但 jsdelivr 有两个限制: 单文件不能大于 20M, 仓库的某版本不能大于 50M, 那这里就有问题了, 我的 xz 是 35M, 超过限制了, 这里我就要找解决方案了

解决之路

思考

首先是分拆, 这个好说, macOS 的 split 命令就支持

那合并呢? cat 命令就可以了

但怎么在 pod 中做呢, 我搜了一下 podspec 的语法, 发现可以配置 prepare_command 参数, 这个参数在安装时会被使用, 并且使用完毕后才会校验库是否存在

我们可以在这一步中来做真实的下载和合并操作

有了完整思路, 我要开始着手实施了

发包

前提:
假设我本地有一个 framework.tar.xz, 这个是已经打包好的库文件

分割文件

split -b 10m IJKMediaFramework.tar.xz IJKMediaFramework.tar.xz.

这里要注意最后一个参数最后有一个. 这样就能完成拆分

ll IJKMediaFramework.tar.xz*
-rw-r--r--  1 caijinglong  staff    33M  3 18 11:34 IJKMediaFramework.tar.xz
-rw-r--r--  1 caijinglong  staff    10M  3 18 11:34 IJKMediaFramework.tar.xz.aa
-rw-r--r--  1 caijinglong  staff    10M  3 18 11:34 IJKMediaFramework.tar.xz.ab
-rw-r--r--  1 caijinglong  staff    10M  3 18 11:34 IJKMediaFramework.tar.xz.ac
-rw-r--r--  1 caijinglong  staff   3.0M  3 18 11:34 IJKMediaFramework.tar.xz.ad

测试一下合并

cat IJKMediaFramework.tar.xz.* > IJKMediaFramework-Test.tar.xz

ll IJKMediaFramework-Test.tar.xz
-rw-r--r--  1 caijinglong  staff    33M  3 18 13:58 IJKMediaFramework-Test.tar.xz

这里大小是 ok 的. 再解压一下试试

mkdir test
mv IJKMediaFramework-Test.tar.xz test
cd test
tar xvf IJKMediaFramework-Test.tar.xz


ll
drwxr-xr-x  7 caijinglong  staff   224B  3 18 11:33 IJKMediaFramework.framework
-rw-r--r--  1 caijinglong  staff   1.0K  3 18 11:33 LICENSE

ll IJKMediaFramework.framework
total 295944
drwxr-xr-x  14 caijinglong  staff   448B  3 18 11:33 Headers
-rw-r--r--   1 caijinglong  staff   130M  3 18 11:33 IJKMediaFramework
-rw-r--r--   1 caijinglong  staff   757B  3 18 11:33 Info.plist
drwxr-xr-x   3 caijinglong  staff    96B  3 18 11:33 Modules
drwxr-xr-x   4 caijinglong  staff   128B  3 18 11:33 libyuv

解压缩也成功了, 接着就是编写脚本了

合并脚本

我创建了一个 cat.sh 脚本

wget https://cdn.jsdelivr.net/gh/CaiJingLong/[email protected]/IJKMediaFramework.tar.xz.aa
wget https://cdn.jsdelivr.net/gh/CaiJingLong/[email protected]/IJKMediaFramework.tar.xz.ab
wget https://cdn.jsdelivr.net/gh/CaiJingLong/[email protected]/IJKMediaFramework.tar.xz.ac
wget https://cdn.jsdelivr.net/gh/CaiJingLong/[email protected]/IJKMediaFramework.tar.xz.ad
cat IJKMediaFramework.tar.xz.* > IJKMediaFramework.tar.xz
tar xvf IJKMediaFramework.tar.xz
rm IJKMediaFramework.tar.xz.* IJKMediaFramework.tar.xz

这个脚本会完成下载, 连接, 解压, 删除压缩包的过程, 这样剩余的就是干净的文件了, 只包含 Framework LICENSE README

上传 github

这里根据你自己的情况选择上传方式, 我是用的 python 脚本配合 github 的 rest v3 api 上传的, 你可以用 git 或者 gihtub 的网页端
接着有一步很重要的步骤, release 这个版本, 不然 jsdelivr 找不到

我的脚本地址: https://gitee.com/kikt/ijkplayer_thrid_party/blob/master/ios/pod/upload.py 需要配置两个环境变量 一个是版本号 一个是 GITHUB_TOKEN, 当然如果想要用的话, 还是需要其他修改的, 比如仓库名, 拥有者名等等信息

podspec

Pod::Spec.new do |spec|

  version = "0.2.2"
  spec.name         = "FlutterIJK"
  spec.version      = "#{version}"
  spec.summary      = "IJKPlayer for Flutter."
  spec.description  = <<-DESC
  IJKPlayer for flutter
                   DESC

  spec.homepage     = "https://github.com/CaiJingLong/flutter_ijkplayer_pod"
  spec.license      = { :type => 'MIT', :file =>'LICENSE' }
  spec.author             = { "Caijinglong" => "[email protected]" }
  spec.source       = { :http => "https://cdn.jsdelivr.net/gh/CaiJingLong/flutter_ijkplayer_pod_spliter@#{version}/README.tar.gz"}
  spec.vendored_frameworks = 'IJKMediaFramework.framework'
  spec.frameworks  = "AudioToolbox", "AVFoundation", "CoreGraphics", "CoreMedia", "CoreVideo", "MobileCoreServices", "OpenGLES", "QuartzCore", "VideoToolbox", "Foundation", "UIKit", "MediaPlayer"
  spec.libraries   = "bz2", "z", "stdc++"

  spec.platform = :ios
  spec.ios.deployment_target = '8.0'
  spec.requires_arc = true

  spec.prepare_command = <<-CMD
    sh cat.sh
  CMD
end

这样在 pod install 的过程中会完成如下步骤

1. 下载 https://cdn.jsdelivr.net/gh/CaiJingLong/flutter_ijkplayer_pod_spliter@#{version}/README.tar.gz 文件 version 是字符串插值的版本号
2. pod 会帮我们解压这个 gz
3. 运行 gz 中的 cat.sh 脚本来完成下载, 合并, 删除多余文件的操作

trunk, 也就是上传的信息:

Updating spec repo `trunk`
  CDN: trunk Relative path: deprecated_podspecs.txt modified during this run! Returning local
  CDN: trunk Going to update 15 files
  CDN: trunk Relative path: all_pods_versions_1_1_5.txt modified during this run! Returning local
  CDN: trunk Relative path: all_pods_versions_4_9_1.txt modified during this run! Returning local
  CDN: trunk Relative path: all_pods_versions_1_1_7.txt modified during this run! Returning local
  CDN: trunk Relative path: all_pods_versions_5_d_c.txt modified during this run! Returning local
  CDN: trunk Relative path: AlgoliaSearch.yml modified during this run! Returning local
  CDN: trunk Relative path: all_pods_versions_e_9_d.txt modified during this run! Returning local
  CDN: trunk Relative path: all_pods_versions_2_1_1.txt modified during this run! Returning local
  CDN: trunk Relative path: CocoaPods-version.yml modified during this run! Returning local
  CDN: trunk Relative path: all_pods_versions_7_f_a.txt modified during this run! Returning local
  CDN: trunk Relative path: all_pods_versions_d_6_9.txt modified during this run! Returning local
  CDN: trunk Relative path: all_pods_versions_6_0_4.txt modified during this run! Returning local
  CDN: trunk Relative path: all_pods_versions_f_4_e.txt modified during this run! Returning local
  CDN: trunk Relative path: all_pods_versions_8_d_3.txt modified during this run! Returning local
  CDN: trunk Relative path: all_pods_versions_1_9_2.txt modified during this run! Returning local
  CDN: trunk Relative path: all_pods_versions_c_e_7.txt modified during this run! Returning local
  - Data URL: https://raw.githubusercontent.com/CocoaPods/Specs/48458c6e0cf376dcb2c374f6b349b960fefa883c/Specs/4/9/1/FlutterIJK/0.2.2/FlutterIJK.podspec.json
  - Log messages:
    - March 17th, 21:06: Push for `FlutterIJK 0.2.2' initiated.
    - March 17th, 21:06: Push for `FlutterIJK 0.2.2' has been pushed (0.922508893 s).

这样就完成了发包的全过程

组织结构

下面是发包时的目录结构

tree output/
output/
├── IJKMediaFramework.framework
│   ├── Headers
│   │   ├── IJKAVMoviePlayerController.h
│   │   ├── IJKFFMonitor.h
│   │   ├── IJKFFMoviePlayerController.h
│   │   ├── IJKFFOptions.h
│   │   ├── IJKKVOController.h
│   │   ├── IJKMPMoviePlayerController.h
│   │   ├── IJKMediaFramework.h
│   │   ├── IJKMediaModule.h
│   │   ├── IJKMediaPlayback.h
│   │   ├── IJKMediaPlayer.h
│   │   ├── IJKNotificationManager.h
│   │   └── IJKSDLGLViewProtocol.h
│   ├── IJKMediaFramework
│   ├── Info.plist
│   ├── Modules
│   │   └── module.modulemap
│   └── libyuv
│       ├── include
│       │   ├── libyuv
│       │   │   ├── basic_types.h
│       │   │   ├── compare.h
│       │   │   ├── compare_row.h
│       │   │   ├── convert.h
│       │   │   ├── convert_argb.h
│       │   │   ├── convert_from.h
│       │   │   ├── convert_from_argb.h
│       │   │   ├── cpu_id.h
│       │   │   ├── macros_msa.h
│       │   │   ├── mjpeg_decoder.h
│       │   │   ├── planar_functions.h
│       │   │   ├── rotate.h
│       │   │   ├── rotate_argb.h
│       │   │   ├── rotate_row.h
│       │   │   ├── row.h
│       │   │   ├── scale.h
│       │   │   ├── scale_argb.h
│       │   │   ├── scale_row.h
│       │   │   ├── version.h
│       │   │   └── video_common.h
│       │   └── libyuv.h
│       └── lib
│           └── libyuv.a
├── IJKMediaFramework.tar.xz
├── IJKMediaFramework.tar.xz.aa
├── IJKMediaFramework.tar.xz.ab
├── IJKMediaFramework.tar.xz.ac
├── IJKMediaFramework.tar.xz.ad
├── LICENSE
├── README.md
├── README.tar.gz
├── cat.sh
└── files

lipo 脚本

另外, 我的项目中, 我还编写了一个 lipo 脚本, 用于合并产物, 分割文件, 调用上传的 python

https://gitee.com/kikt/ijkplayer_thrid_party/blob/master/ios/lipo_product.sh

后记

本篇没有单独的仓库, 但是可以参考 https://gitee.com/kikt/ijkplayer_thrid_party/blob/master/ios/lipo_product.sh 来作为入口看整个过程

以上