博客原地址:http://foggry.com/blog/2016/03/23/cocoapods-xiang-jie-zhi-geng-xin-pian/
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 时,需要注册自己的电脑:
执行命令以后,上述邮箱会收到一封验证邮件,按照邮件说明打开制定的链接,注册流程就完成了。
注册流程完成后,可以使用命令:
可以检验注册结果,如果输出:
则说明注册成功。
2、提交组件
准备好 podspec 文件后,首先要检查其合法性:
解决完错误和警告后,会显示以下内容:
这就说明验证可以提交了。
执行提交命令:
如果顺利的话,会输出以下内容:
仅需要这一条命令,开源组件就被推送到 CocoaPods 主仓库中了。可以执行以下命令验证下:
输出为:
说明组件 WZMarqueeView
已经成功从 1.0.0
升级成了 2.0.0
版本。
3、其它说明
- 权限声明
在执行下述命令时:
提示了以下错误:
原来,Trunk 要求只有组件所有者和开发者才能更新已有组件,而上例的组件 WZMarqueeView
是 2014 年通过 Pull requests 方式上传到 CocoaPods 主仓库的,并没有声明过所有权。
随后,到 CocoaPods 指定的网页:Claim your Pod上填写对应信息后,按照提示执行命令:
看到执行结果:
组件的所有权已经变成了本人,此时再去执行 trunk push
命令时就正常了。
- 为组件添加其它所有者
一个组件可以通过以下命令,添加多个所有者(以邮箱为标识):
执行成功后,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、本地初始化组件仓库
执行以下命令:
3、向仓库中添加组件
将事先准备好的组件添加到仓库中,组件可以存放在本地,也可以放在自家或网上的代码托管平台。执行以下命令:
执行成功以后,会有以下输出:
至此,本地和代码托管平台上的私有仓库 FGSpecs 中就都已经添加了私有组件 FGMarqueeView。
4、使用私有仓库中的组件
Podfile 文件中默认情况下已经隐式使用 source
声明了 CocoaPods 的官方仓库。但使用私有组件,需要使用 source
关键字鲜显式声明组件所在仓库:
其中,SBJson 组件是官方仓库的,FGMarqueeView 组件属于我们刚创建的私有仓库。
需要注意的是:
- 官方仓库的显式声明
尽管官方仓库会被隐式声明,如果同时使用了官方仓库和私有仓库,就需要同时声明二者。
- 仓库声明顺序性
先声明的仓库具有优先权。当先后引用的两个仓库中都包含同一个组件时,会使用先引用仓库中的,哪怕后引用的仓库中版本号更高。
5、直接使用私有组件
如果不想创建私有仓库,也可以在 Podfile 里直接引用私有组件(组件可以是本地的,也可以是托管在自家公司服务器或网上的代码托管平台上的),引用的同时还可以制定具体的 commit、branch 或者 tag,比如:
这种方式引用的组件在执行完 pod install
以后,会被添加在 Development Pods 目录下,而通过私有仓库或共有仓库方式引用的组件则会被添加在 Pods 目录下。
三、cocoapods 版本管理
cocoapods 升级新版本后可能会遇到坑,因此就有了降级的需求。
- 查看当前版本
- 卸载当前版本
- 安装指定版本