知乎 iOS 客户端基于 CocoaPods 实现的二进制化方案
Posted 程序员专栏
tags:
篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了知乎 iOS 客户端基于 CocoaPods 实现的二进制化方案相关的知识，希望对你有一定的参考价值。
作者丨老邢Thierry
https://www.jianshu.com/p/b64a2b268588
随着公司业务规模的增长，ios 客户端的代码量也越来越大，编译一次项目的时间也越来越长。减少编译时间成了一个不得不面对的问题。
现有的二进制方案如 Carthage、Rome 等都是在本地生成 framework，没法实现「一次编译，处处使用」的目标。
为了实现这个目标，就需要一个人或者一个 CI Job，把编译好的二进制产物上传到某个的地方，集中化地管理这些二进制形式的依赖。
然后在每个人 pod install 的时候，检查该 pod 版本对应的二进制是否存在，如果有就使用，没有就继续采用源码的方式依赖。
上面的方案隐藏了许多细节，比如到底应该如何集中管理这些 pod，如何知道对应的版本是否存在，如何在 pod install 的时候动态地把这些 pod 从源码形式的依赖换成二进制形式的依赖等等。
因为这整个流程涉及生产方（产生二进制）和消费方（使用二进制），我就把整个方案分为两个流程详细介绍一下。
产生二进制
代码结构
产生二进制的流程在一个 CI Job 中，每隔一段时间，它会同步主仓库最新的 dev 分支，然后运行管理此环节的工具，Platypus。
它的结构如下：
config.yml 是与工程相关联的配置，其中包含了需要二进制化的名单（pod_names），project 文件相关信息，以及工程初始化的 action（prebuild_action）等等。
specs_repo 是私有的 podspec 仓库，需要单独创建，负责集中管理已经二进制好的 pod 信息。
具体流程
如下图：
下面是各个步骤的详细说明，
对于大多数项目来说是 pod install，但如果在不改变 podfile 原有写法的基础上实现此套方案，需要把使用 patch 过后的 pod install 方式，这个在使用二进制这个部分会详细说明。
白名单存在的意义有两点，一是有些 pod 本来就是二进制好了的；二是某些 pod 因为头文件没有用 < > 的方式引用在目前阶段没法二进制，否则就会因为找不到头文件编译失败。
模拟器和真机的版本都需要编译，最终使用 lipo 把两份二进制合并到一个 .framework 中。如果 pod 中包含 Swift 代码，需要把模拟器和真机的编译产物中的 swiftdoc 和 swiftmodule 都合并到一个文件夹中。由于 Swift 版本的原因，由旧版 Xcode 编译生成 Swift 二进制是无法在新版 Xcode 中使用的。
通过 CocoaPods 中的 Analyzer 调用 analyzer.analyze.specifications，可以获取当前项目所有依赖 pod 的 podspecs，关于如何编辑 podspec，可以使用这个 gem。编辑的内容包括删掉 source_files 字段，把 vendored_frameworks 字段指向 .framework， source 指向上传生成的 URL， resources 指向对应 .framework 中的资源等等。保存后，作为二进制时依赖使用的 podspec。
这一步是为了把项目中依赖的 pod 版本与二进制化后的版本建立起联系。因为项目中依赖的引用方式五花八门，有用 CocoaPods Master Repo 中版本号的，有用 git tag 的，也有用 git commmit 的，针对不同的引用方式，都要有对应的匹配规则，比如有一个使用 tag 方式引用的组件，把它的 tag 号后面加上 -zhihu-static 作为它在私有 Specs 仓库中的版本号，它在 podfile 中的 external_source 作为 summary 字段，同时确保唯一性。这里的映射关系只要能一一对应起来，随便怎么建立都好。
pod 'ABC', git: 'git@git.xxx.com:xxx/ABC.git', tag: '4.24.0.9'
所以它被改完版本号后 poddpec 会长成这个样子，
{
"name": "ABC",
"version": "4.24.0.9-zhihu-static",
"summary": "{:git=>\"git@git.xxx.com:xxx/ABC.git\", :tag=>\"4.24.0.9\"}"
...
}
h) Specs 仓库目录结构如下所示，目录均为手动创建，没有使用 CocoaPods 提供的方式更新。
├── A
│ └── 4.22.0.8-zhihu-static
│ └── A.podspec.json
├── B
│ ├── 0.2.21-zhihu-static
│ │ └── B.podspec.json
│ └── 0.2.9-zhihu-static
│ └── B.podspec.json
├── C
│ └── 1.4.0-zhihu-static
│ └── C.podspec
└── D
└── 2.5.0-zhihu-static
└── D.podspec
使用二进制
在触发 pod install 过程之前，需要在本地把私有 Specs 仓库更新到最新，pod repo update xxx。
接下来就是 patch pod install 替换依赖的过程了。在不更改 podfile 的情况下，只能模仿 pod install 的过程，自己创建一个脚本来替代这个操作了。
整个过程不复杂，可以参考下面这一段带注释的代码，
# 参考 `CocoaPods` 的源码，模拟 `pod install` 执行的过程
argv = CLAide::ARGV.new([])
cmd = Pod::Command.new(argv)
cmd.send :verify_podfile_exists!
installer = cmd.send :installer_for_config
installer.repo_update = false
installer.update = false
podfile = installer.podfile
# 获取此次 install 的配置，是全部使用二进制还是全部使用源码
# 全部使用二进制时，哪些 pod 依旧使用源码引入
use_all_binary, source_pod_list = ZHPodInstallHelper.read_binary_pods_pref
use_all_binary = false if ENV['ALL_SOURCE'] == 'true'
unless use_all_binary
puts '以上是关于知乎 iOS 客户端基于 CocoaPods 实现的二进制化方案的主要内容，如果未能解决你的问题，请参考以下文章
基于 Cocoapods 的 iOS 项目的示例 .travis.yml