Cocoa​Pods

文明是建立在道路,桥梁,运河,下水道,管线,电线和光纤这些基础设施之上的。只要设计和施工得当,它们可以帮助社会成倍的发展。

唯一的问题就是可扩展性。

不管是在一个新的区域容纳上百万家庭还是整合大量的开发者到新的语言环境中去,挑战都是相同的。

在 Objective-C 的情况下,CocoaPods提供了一个绝佳的整合合作开发的工具,并且在快速发展的开发社区中起到了一个集结点的作用。

本周的 NSHipster,我们将通过讨论 CocoaPods 的过去,现在以及将来,一起庆祝 0.33 版本(具有里程碑意义)的发布。

接下来的对 CocoaPods 起源的历史回顾比较冗长,如果你只在乎技术细节,点此直接跳过


回望

在 Objective-C 在它存在的前 20 年左右几乎鲜为人知。NeXT 和后来的 OS X 作为一个边缘平台,只拥有一个相对较小的用户和开发者社区。像所有的社区一样,本地用户小组,邮件列表和网站该有的都有,但是开源合作开发缺很少见。诚然,开源在那时也只处于起步阶段,但是 Objective-C 却从未有过类似于 CPAN (the Comprehensive Perl Archive Network)的组织。所有人除了能从 Redwood 和 Cupertino 拿到 SDK(或者在论坛搜寻一下可用的代码)以外,剩下的问题只能靠自己解决。

Objective-C 和 iPhone

这种情况一直持续到了 2008 年的夏天,当 iPhone OS 开始对第三方开发者开放的时候。几乎一夜之间,Objective-C 从无人问津变的炙手可热。上百万开发者的涌入,给这门语言注入了新鲜的血液。

就在此时,GitHub 也刚刚发布,并且开始通过新的分布式合作开发方式改变我们对开源的认知。

一大批开源项目开始涌现,例如 ASIHTTPRequest 和 Facebook 的 Three20。这些早期的库和框架主要是用来填补 iPhone OS 2.0 和 3.0 开发中遇到空白,并且在后续的 OS 迭代中慢慢被遗弃或取代,但是它们突破了每个开发者“单打独斗”的局面。

在这波新的开发者中,那些来自 Ruby 背景的对 Objective-C 起来了很大的影响。Ruby 作为 Perl 的精神继承者,有一个类似于 CPAN 的包管理器:RubyGems

为什么受 Ruby 的影响这么大?我的理论是:Ruby 是在Rails 2005 年发布 1.0 版本的时候开始流行起来。假设创业公司的平均寿命在 1.5 到 2.5 年之间,那么此时第一批厌倦 Rails 的开发者正好可以跳上移动开发的大船上。

就在 Objective-C 开源开发渐入佳境之时,代码分发的痛点开始显现:

缺乏框架,iOS 的代码虽然可以被打包成静态库,但是配置和同步分发却成了一个艰巨的任务。

另外一个思路是用 Git Submodules 把源码直接放入项目。但是链接框架和配置生成环境的繁琐也使得这种方法也没有好到哪里去,尤其是当ARC 和 non-ARC的代码需要分开的时候。

进入 CocoaPods 时代

CocoaPods 是由Eloy Durán于 2011 年 8 月 12 日创建。

在 Bundler 和 RubyGems 的启发下,CocoaPods 被设计成即能处理库之间的依赖关系,又能自动下载并且配置好所需要的库。试想一下开发只有松散文档编制的 Xcode 项目的难度,CocoaPods 的存在简直就是奇迹。

另一个早先的决定就是利用central Git repository作为所有库的总数据库。虽然这带来了一些运筹上的顾虑,好在 GitHub 能够提供一个稳健的平台,帮助团队在后续的迭代中,开发出更好的工具链。

时至今日,CocoaPods 已经壮大拥有 14 个核心开发人员和多达5000 个开源项目。绝大部分项目都是来自于 Objective-C 开源社区,我们应该感谢每一个参与其中的开发者。


使用 CocoaPods

制作和使用 CocoaPods 库都十分简单,往往几分钟就能配置完毕。

想获取最新的官方教程,请前往此处

安装 CocoaPods

CocoaPods 可以方便地通过 RubyGems 安装,打开 Terminal,然后键入以下命令:

$ sudo gem install cocoapods

就这么简单,现在你应该可以开始使用 pod 命令了。

如果你使用 Ruby 版本管理器,如rbenv,你可能需要运行以下指令来重新链接 shim 的二进制文件(例如:$ rbenv rehash)。

管理相关性

一个相关性管理器可以将一系列的软件需求转化为具体的标签,然后下载并且整合进入相关的项目。

申明需求可以自动化整个项目配置,这也是软件开发的最佳实践之一,无论是在任何语言中。甚至你不使用第三方库,CocoaPods 仍然是一个管理代码相关性的绝佳工具。

Podfile

Podfile这个文件是用来用来申明项目代码相关性的,正如BundlerGemfile,或者npmpackage.json

cd进入.xcodeproj文件所在的目录,通过以下命令来创建一个 Podfile

$ pod init

Podfile

platform :ios, '7.0'

target "AppName" do

end

你可以申明需要不同版本的库,大部分情况下,申明到 minor 或者 patch 版本就足够了

pod 'X', '~> 1.1'

CocoaPods 遵循语意化版本规范

对于那些不在 CocoaPods 公共 Git 仓库中的库,你可以用任何一个 Git, Mercurial 或者 SVN 仓库取代,并且还可以指定具体的 commit, branch 或者 tag。

pod 'Y', :git => 'https://github.com/NSHipster/Y.git', :commit => 'b4dc0ffee'

一旦所有的相关性都申明完毕,你可以使用以下指令来安装所需要的库:

$ pod install

安装过程中,CocoPods 会使用递归来分析所有的需求,并且建立一个代码相关性的图,最后将 Podfile 序列化为Podfile.lock

比如,如果两个库都需要使用AFNetworking,CocoaPods 会确定一个同时能被这两库使用的版本,然后将同一个安装版本链接到两个不同的库中。

CocoaPods 会创建一个新的包含之前安装好的静态库 Xcode 项目,然后将它们链接成一个新的 libPods.a target。你原有的项目将会依赖这个新的静态库。一个 xcworkspace 文件会被创建,从此之后,你应该只打开这个 xcworkspace 文件来进行开发。

反复使用 pod install 命令,只会让 CocoaPods 重复以上步骤,重新安装这些库。所以,当你需要升级它们时,请使用以下命令:

$ pod update

试着使用 CocoaPod

try是一个及其实用但又鲜为人知的 CocoaPods 命令,通过它你能够在安装一个库之前,先试用一下。

你只需要在try后面加上任意一个 CocoaPods 公共库的名称,就能试用它了!

$ pod try Ono

建立自己的 CocoaPod

作为 Objective-C 软件分发实际上的标准,CocoaPods 几乎是所有开源项目的标配,如果你想让你的项目被大家很方便地使用。

诚然,这会提高一点点你分享项目的门槛,但是,好处是显然易见的。你花几分钟创建一个.podspec文件可以节省下其他开发者无数的时间。

规范

.podspec文件作为 CocoaPods 的一个独立单元,包含了名称,版本,许可证,和源码文件等所有信息。

官方指南中有许多信息和范例

以下是 NSHipsterKit.podspec

Pod::Spec.new do |s|
  s.name     = 'NSHipsterKit'
  s.version  = '1.0.0'
  s.license  = 'MIT'
  s.summary  = "A pretty obscure library.
                You've probably never heard of it."
  s.homepage = 'https://nshipster.com'
  s.authors  = { 'Mattt Thompson' =>
                 'mattt@nshipster.com' }
  s.social_media_url = "https://twitter.com/mattt"
  s.source   = { :git => 'https://github.com/nshipster/NSHipsterKit.git', :tag => '1.0.0' }
  s.source_files = 'NSHipsterKit'
end

一旦把这个.podspec发布到公共数据库中,任何想使用它的开发者,只需要在 Podfile 中加入如下声明即可:

Podfile

pod 'NSHipsterKit', '~> 1.0'

.podspec文件也可以作为管理内部代码的利器:

pod 'Z', :path => 'path/to/directory/with/podspec'

发布 CocoaPod

CocoaPods 0.33 中加入了Trunk服务。

虽然一开始使用 GitHub Pull Requests 来整理所有公共 pods 效果很好。但是,随着 Pod 数量的增加,这个工作对于 spec 维护人员Keith Smiley来说变得十分繁杂。甚至一些没有通过$ pod lint的 spec 也被提交上来,造成 repo 无法 build。

CocoaPods Trunk 服务的引入,解决了很多类似的问题。CocoaPods 作为一个集中式的服务,使得分析和统计平台数据变得十分方便。

要想使用 Trunk 服务,首先你需要注册自己的电脑。这很简单,只要你指明你的邮箱地址(spec 文件中的)和名称即可。

$ pod trunk register mattt@nshipster.com "Mattt Thompson"

至此,你就可以通过以下命令来方便地发布和升级你的 Pod!

$ pod trunk push NAME.podspec

已经发布 Pod 的作者可以通过几个简单的步骤来声明所有权。


展望

CocoaPods 例证了一个社区的凝聚力。在短短的几年内,Objective-C 社区让我们所有人都引以为傲。

CocoaPods 仅仅是众多 Objective-C 基础设施的一部分,还有诸如Travis CI, CocoaDocsNomad这些非常好的生产力工具。

虽然整个社区的未来不会一帆风顺,不管怎样,让我们怀着信念,尽可能的提供建设性的意见。我们更应该互相帮助,乐于分享,共同努力推动整个社区的进步!

CocoaPods 已经是 Objective-C 不可或缺的一部分,它只会越来越强大!

作者 Mattt
Mattt

Mattt (@mattt) is a writer and developer in Portland, Oregon. He is the founder of NSHipster and Flight School, and the creator of several open source libraries, including AFNetworking and Alamofire.

翻译者
David Liu

混迹于美帝的工程师,户外运动爱好者。

下一篇文章

随便去问任何人,他们都会告诉你WWDC2014是近年来最为激动的回忆。这周,我们将拨开iOS 8的云雾,探讨一些所有人都应该知道新API。