使用 CocoaPods 管理依赖库

文本首发于Ryan’s Zone

本篇内容将介绍Mac和iOS开发中必备的一个依赖库管理工具CocoaPods。

CocoaPods是什么

在iOS开发中势必会用到一些第三方依赖库，好比你们都熟悉的ASIHttpRequest、AFNetworking、JSONKit等。使用这些第三方类库能极大的方便项目的开发，可是，集成这些依赖库须要咱们手动去配置，例如集成ASIHttpRequest库时除了加入源码之外还须要手动去添加一些系统框架，好比CFNetwork、MobileCoreServices等，若是这些第三方库发生了更新，还须要手动去更新项目。这就显得很是麻烦。有麻烦天然有解决办法，CocoaPods就是为了解决这个问题而生的。经过CocoaPods，咱们能够将第三方的依赖库统一管理起来，配置和更新只须要经过简单的几行命令便可完成，大大的提升了实际开发中的工做效率，使咱们的主要精力集中到更重要的事情上去。

安装CocoaPods
个人环境为Mac OS X 10.9.1，安装CocoaPods以前，先确保本地有Ruby环境，由于CocoaPods运行于Ruby之上，默认状况下，Mac是自带了Ruby环境的，能够经过命令行“`ruby -v“`查看当前Ruby的版本，我用的是1.9.3p448。接下来咱们就能够经过以下命令安装CocoaPods了。

$ sudo gem install cocoapods

输入上述命令后可能会无响应，那是由于你身在天朝，伟大的墙拦住了你的去路，不知为何，cocoapods.org这种无害产物也要被墙。不过不要紧，咱们能够经过淘宝的Ruby镜像来访问Cocoapods，在终端输入以下命令将Ruby镜像替换为淘宝的。

$ gem sources –remove https://rubygems.org/
$ gem sources -a http://ruby.taobao.org/

完成后能够经过以下命令来查看当前的Ruby镜像是否已经指向了淘宝的。

$ gem sources -l

若是输出结果是以下这样，那说明这一步就成功了。

*** CURRENT SOURCES ***

http://ruby.taobao.org/

接下来就能够从新运行安装命令来安装CocoaPods了，根据你的网络状况，几秒或十几秒后安装过程就完成了，总的来讲，安装过程仍是比较简单的。若是其中你遇到了什么问题，请自行Google解决，都能找到你想要的答案。

使用CocoaPods
咱们经过集成JSONKit类库来演示如何使用CocoaPods来作依赖库管理。首先，创建一个xcode工程，命名为CocoaPodsTest，如今的工程结构以下图所示。

这里咱们要集成JSONKit，能够先经过以下命令来判断其是否支持CocoaPods。

“`
$ pod search JSONKit
“`

执行后经过输出结果能够看到JSONKit是支持CocoaPods的，注意红框标记的内容，这是待会咱们配置xcode时须要的信息，这条配置项就是告诉CocoaPods去下载和管理哪个第三方库。

检测完毕后咱们来到工程CocoaPodsTest的目录下，新建一个名为Podfile的文件（这里经过命令行建立）

$ vim Podfile

这个Podfile文件的做用是配置依赖库信息，就是告诉CocoaPods去下载和管理哪些依赖库，文件建立好之后，打开文件并加入以下内容。（vim打开文件后按i进入插入模式，编辑完成后按esc退出编辑模式，接着输入:wq保存并退出文件）

这时候，工程目录下就会有一个Podfile文件了，注意必须和.xcodeproj在同一个目录下。接下来就可使用CocoaPods来安装并管理JSONKit库了，确保命令行当前路径是在CocoaPodsTest目录下，运行以下命令。

$ pod install

安装完成后会提示以下信息，而且咱们的工程目录下会多出一个.xcworkspace结尾的文件，命令行信息绿色部分提醒咱们“今后使用CocoaPodsTest.xcworkspace来打开项目”。

经过CocoaPodsTest.xcworkspace来打开项目，这时，咱们的项目工程结构就会变成下图这样，多出一个名为Pods的依赖工程，打开Pods文件夹后，发现JSONKit已经在里面了

这时候就能够在项目文件中引入JSONKit.h了，这时候若是你发现import的时候没有提示JSONKit的文件，能够在target-Build Settings下修改“User Header Search Paths”项，新增${SRCROOT}并选择rcursive，以下图。

设置完成后就能够在文件中直接引用第三方库的文件并使用了。

到此，新建工程并使用CocoaPods来管理依赖库的过程就完成了，若是是直接使用已有CocoaPods的项目，则须要首先运行一下pod update命令来更新项，而后照样经过.xcworkspace来打开工程。

若是须要依赖多个第三方类库，只须要修改Podfile文件的配置，而后运行pod update命令便可，好比新增一个AFNetworking的依赖库，首先执行pod search AFNetworking查看一下AFNetworking的配置信息，修改Podfile文件，在后面增长AFNetworking的对应配置信息，而后运行pod update命令就完成了对AFNetworking的集成。

添加AFNetworking库后的目录结构以下。

若是类库有更新，查看更新配置并执行pod update便可简单完成了，今后从手动更新繁重的体力劳动中解脱出来。

简单小结一下：

- 安装CocoaPods- 新建项目并在工程根目录下新建Podfile文件，配置须要管理的第三方库- 运行pod install下载安装第三方库