CocoaPods 大概是 2011 年出现的开源组件管理工具(目前已支持 Objective-C 和 Swift),近年来普及率越来越高,几乎已是所有 Cocoa 开源项目的标配。另外,很多大点的团队会用 CocoaPods 拆分工程,实现项目插件化。
博主曾在 2014 年写过 CocoaPods 详解 系列文章:CocoaPods详解之—-使用篇、CocoaPods详解之—-进阶篇、CocoaPods详解之—-制作篇,简单介绍了从使用到亲手制作 CocoaPods 开源组件的过程。
然而随着时间的推移,CocoaPods 有些使用方式也发生了变化,比如组件提交方式等。本文将从 Trunk 和私有仓库两个方面介绍自己对 CocoaPods 的新认识。
一、Trunk 方式提交开源组件
从 CocoaPods 0.33 版本开始,CocoaPods 将组件的提交从 Pull requests 变成了自动化的 Trunk 方式。Trunk 提交方式有以下步骤:
1、向 Trunk 注册自己的电脑
首次使用 Trunk 时,需要注册自己的电脑:
1 | # pod trunk register [E-mail] [User Name] |
执行命令以后,上述邮箱会收到一封验证邮件,按照邮件说明打开制定的链接,注册流程就完成了。
注册流程完成后,可以使用命令:
1 | $ pod trunk me |
可以检验注册结果,如果输出:
1 | - Name: foggry |
则说明注册成功。
2、提交组件
准备好 podspec 文件后,首先要检查其合法性:
1 | # Enter podspec path |
解决完错误和警告后,会显示以下内容:
1 | -> FGMarqueeView (1.0.0) |
这就说明验证可以提交了。
执行提交命令:
1 | $ pod trunk push WZMarqueeView.podspec |
如果顺利的话,会输出以下内容:
1 | Updating spec repo `master` |
仅需要这一条命令,开源组件就被推送到 CocoaPods 主仓库中了。可以执行以下命令验证下:
1 | $ pod search WZMarqueeView |
输出为:
1 | -> WZMarqueeView (2.0.0) |
说明组件 WZMarqueeView 已经成功从 1.0.0 升级成了 2.0.0 版本。
3、其它说明
- 权限声明
在执行下述命令时:
1 | $ pod trunk push WZMarqueeView.podspec |
提示了以下错误:
1 | Updating spec repo `master` |
原来,Trunk 要求只有组件所有者和开发者才能更新已有组件,而上例的组件 WZMarqueeView 是 2014 年通过 Pull requests 方式上传到 CocoaPods 主仓库的,并没有声明过所有权。
随后,到 CocoaPods 指定的网页:Claim your Pod上填写对应信息后,按照提示执行命令:
1 | $ pod trunk info WZMarqueeView |
看到执行结果:
1 | WZMarqueeView |
组件的所有权已经变成了本人,此时再去执行 trunk push 命令时就正常了。
- 为组件添加其它所有者
一个组件可以通过以下命令,添加多个所有者(以邮箱为标识):
1 | # pod trunk add-owner [Module Name] [Owner E-mail] |
执行成功后,kyle@cocoapods.org 也变成了 WZMarqueeView 的所有者。
- Pull requests 和 Trunk 对比
对于开发者来说,Pull requests 的操作过程十分繁琐,需要开源组件制作者先 fork 一份主仓库,然后将组件提交到 fork 后的仓库,再 Pull requests 给 CocoaPods 主仓库的维护者;
对 CocoaPods 主仓库的维护者来说,需要手工一个个处理主仓库的合并操作,通常第二天甚至需要更长时间 requests 才能被处理;
而 Trunk 方式,开发者只需要一条命令就能将组件上传到主仓库,并且 Trunk 方式是自动化的,几乎不再需要主仓库的维护者做任何工作,实时性更好。
另外,Trunk 增加了组件所有者的概念,非所有者无法提交组件的更新,这在一定程度上提高了 CocoaPods 的安全性。
二、创建私有 CocoaPods 仓库
目前所有支持 CocoaPods 的开源组件,都存储在 Github 上公共的 CocoaPods Specs 仓库中,这种方式有以下缺点:
官方仓库过大,里面的绝大多数组件都不是我们需要的,你一定忘不了首次执行 pod install 操作时那无尽的等待;
不能实现私有化,作为一个相当好用的组件管理工具,很多团队都使用 CocoaPods 实现庞大项目的组件化,都放在公共仓库肯定不行。
这时就需要创建一个和 CocoaPods Specs 类似的私有组件存储仓库。私有仓库可以存放在自家公司的 Git 服务器上,也可以放在各大支持私有仓库的 Git 平台上,下面以支持免费私有仓库的 coding.net为例说明 CocoaPods 私有仓库的创建过程。
1、创建coding.net私有仓库
按照 coding.net 官网提示创建一个私有仓库即可。
2、本地初始化组件仓库
执行以下命令:
1 | # pod repo add [Private Repo Name] [GitHub HTTPS clone URL] |
3、向仓库中添加组件
将事先准备好的组件添加到仓库中,组件可以存放在本地,也可以放在自家或网上的代码托管平台。执行以下命令:
1 | # pod repo push [Private Repo Name] [Private podspec Path] |
执行成功以后,会有以下输出:
1 | Validating spec |
至此,本地和代码托管平台上的私有仓库 FGSpecs 中就都已经添加了私有组件 FGMarqueeView。
4、使用私有仓库中的组件
Podfile 文件中默认情况下已经隐式使用 source 声明了 CocoaPods 的官方仓库。但使用私有组件,需要使用 source 关键字鲜显式声明组件所在仓库:
1 | # Private Specs |
其中,SBJson 组件是官方仓库的,FGMarqueeView 组件属于我们刚创建的私有仓库。
需要注意的是:
- 官方仓库的显式声明
尽管官方仓库会被隐式声明,如果同时使用了官方仓库和私有仓库,就需要同时声明二者。
- 仓库声明顺序性
先声明的仓库具有优先权。当先后引用的两个仓库中都包含同一个组件时,会使用先引用仓库中的,哪怕后引用的仓库中版本号更高。
5、直接使用私有组件
如果不想创建私有仓库,也可以在 Podfile 里直接引用私有组件(组件可以是本地的,也可以是托管在自家公司服务器或网上的代码托管平台上的),引用的同时还可以制定具体的 commit、branch 或者 tag,比如:
1 | $ pod 'FGMarqueeView', :git => 'https://git.coding.net/foogry/FGMarqueeView.git', :commit => 'b4dc0ffee' |
这种方式引用的组件在执行完 pod install 以后,会被添加在 Development Pods 目录下,而通过私有仓库或共有仓库方式引用的组件则会被添加在 Pods 目录下。
三、cocoapods 版本管理
cocoapods 升级新版本后可能会遇到坑,因此就有了降级的需求。
- 查看当前版本
1 | sudo gem list cocoapods |
- 卸载当前版本
1 | sudo gem uninstall cocoapods |
- 安装指定版本
1 | sudo gem install cocoapods -v 0.39.0 |