CocoaPods(第三方类库管理工具)

一, CocoaPods是什么?

每种语言发展到一个阶段,就会出现相应的依赖管理工具。随着 iOS 开发者的增多,业界出现了为 iOS 程序提供依赖管理的工具,它的名字叫做:CocoaPods.

CocoaPods现在已经成为 iOS 开发的依赖管理标准工具。开发 iOS 项目不可避免地要使用第三方库,CocoaPods 的出现使得我们可以节省设置和更新第三方开源库的时间。

在没有使用 CocoaPods 以前,我们需要:

  1. 把这些第三方开源库的源代码文件复制到项目中,或者设置成 git 的 submodule。
  2. 对于这些开源库通常需要依赖系统的一些framework,我需要手工地将这些 framework 分别增加到项目依赖中,比如通常情况下,一个网络库ASIHttpRequest(AFNetworking)就需要增加以下 framework: CFNetwork, SystemConfiguration, MobileCoreServices, CoreGraphics, zlib。
  3. 对于某些开源库,我还需要设置-licucore或者 -fno-objc-arc等编译参数
  4. 管理这些第三方库的更新。

这些体力活虽然简单,但毫无技术含量并且浪费时间。在使用 CocoaPods 之后,我只需要将用到的第三方开源库放到一个名为 Podfile 的文件中,然后执行pod install。 CocoaPods 就会自动将这些第三方开源库的源码下载下来,并且为我的工程设置好相应的系统依赖和编译参数

二, CocoaPods下载和安装?

安装方式异常简单, 在安装CocoaPods之前,首先要在本地安装好Ruby环境。 Mac 下都自带 ruby,使用 ruby 的 gem 命令即可下载安装:

$sudo gem install cocoapods

如果你的 gem 太老,可能也会有问题,可以尝试用如下命令升级 gem:

$sudo gem update —-system

另外,ruby 的软件源 https://rubygems.org 因为使用的是亚马逊的云服务,所以被墙了,需要更新一下 ruby 的源,使用如下代码将官方的 ruby 源替换成国内淘宝的源:

$gem sources —-remove https://rubygems.org/

等有反应之后再敲入以下命令:

$gem sources —a https://ruby.taobao.org/

为了验证你的Ruby镜像是并且仅是taobao,可以用以下命令查看:

$gem sources -l

上面所有的命令完成这时候,你再次在终端中运行:

$sudo gem install cocoapods

等上一分钟(根据网速),

最后再执行下面的命令:

$pod setup

成功后,  CocoaPods就可以在你本地下载并且安装好了。

还有一点需要注意,$pod setup在执行时,会输出Setting up CocoaPods master repo,但是会等待比较久的时间。这步其实是 Cocoapods 在将它的信息下载到~/.cocoapods目录下,如果你等太久,可以试着 cd 到那个目录,用du -sh *来查看下载进度。

你也可以参考接下来的使用 CocoaPods 的镜像索引的内容来提高下载速度。

如果上面的pod setup执行很慢,  我们可以用以下方式更换下载路径: (可选)

<如果半个小时内可以下载完成, 则忽略本步骤>

使用 CocoaPods 的镜像索引

所有的项目的 Podspec 文件都托管在https://github.com/CocoaPods/Specs。第一次执行pod setup时,CocoaPods 会将这些podspec索引文件更新到本地的 ~/.cocoapods/目录下,这个索引文件比较大。所以第一次更新时非常慢,更新了将近 1 个小时才完成。

一个叫 akinliu 的朋友在 gitcafe 和 oschina 上建立了 CocoaPods 索引库的镜像,因为 gitcafe 和 oschina 都是国内的服务器,所以在执行索引更新操作时,会快很多。如下操作可以将 CocoaPods 设置成使用 gitcafe 镜像:

$pod repo remove master

$pod repo add master https://gitcafe.com/akuandev/Specs.git

$pod repo update

如果要使用 oschina 上的镜像:  则将以上代码中的 https://gitcafe.com/akuandev/Specs.git 替换成 http://git.oschina.net/akuandev/Specs.git 即可.

三, CocoaPods的使用?

好了,安装好CocoaPods之后,接下来就是使用它。所幸,使用CocoaPods和安装它一样简单,也是通过一两行命令就可以搞定。

1, 利用CocoaPods,在项目中导入AFNetworking类库

AFNetworking类库在GitHub地址是:https://github.com/AFNetworking/AFNetworking

为了确定AFNetworking是否支持CocoaPods,可以用CocoaPods的搜索功能验证一下。在终端中输入:

$pod search AFNetworking

过几十秒钟之后,你会在终端中看到关于AFNetworking类库的一些信息。

接下来创建Xcode工程, 我们在项目中加入CocoaPods的支持;

CocoaPods将会自动下载AFNetworking并加入到工程当中呢,那如何来做呢?  你创建一个Podfile文件(注意,一定得是这个文件名,而且没有后缀),然后在里面添加你需要下载的类库,也就是告诉CocoaPods,“某某和某某和某某某,快到碗里来!”。每个项目只需要一个Podfile文件。

好吧,废话少说,我们先创建这个神奇的Podfile。在终端中进入你项目所在目录(cd命令)

$cd /Users/ijeff/Desktop/cocoaPodsDemo1

然后在当前目录下,利用vim创建Podfile,运行:

$vim Podfile

然后在Podfile文件中输入以下文字:

platform :ios, ‘7.0’

pod “AFNetworking”, “~> 2.0”

这两句文字的意思是,当前AFNetworking支持的平台: ios,

要下载的AFNetworking版本是2.0。

然后保存退出。vim环境下,保存退出命令是:

$:wq

这时候,你会发现你的项目目录中,出现一个名字为Podfile的文件,而且文件内容就是你刚刚输入的内容。

(注意,Podfile文件要在项目文件夹的根目录下。)

这时候,你就可以利用CocoaPods下载AFNetworking类库了。还是在终端中的当前项目目录下,运行以下命令:(–verbose –no-repo-update)

$pod install

运行完$pod install命令后会产生几个新文件。你会发现多了两个文件 “.xcworkspace”, “Podfile.lock”和一个文件夹“Pods”。

注意:  以后打开项目就用 .xcworkspace 打开,而不是之前的.xcodeproj文件。

至此,CocoaPods已经在你的项目中植入,管理了一个第三方库AFNetworking。上面写了这么多,其实过程是十分简单的。总结一下就是:

  1. 先在项目中创建Podfile,Podfile的内容是你想导入的类库。一般类库的原作者会告诉你导入该类库应该如何写Podfile;
  2. 运行命令:$pod install

使用$pod install进行安装时如果出现如下错误:

$ pod install

Analyzing dependencies

[!] Unable to find a specification for `AFNetworking (~> 2.0)`

尝试解决办法:

把当前Pod的目录清理一下就行了。在终端执行以下命令:
pod repo remove master
pod setup
setup成功后执行install

 2, 正确编译运行一个包含CocoaPods类库的项目

在网上下载的项目如果使用了CocoaPods, 则有时候会出现很多错误, 基本都是说你编译的这份代码找不到某某头文件,这就意味着你要成功编译就必须先导入一些第三方类库。同时你会发现在项目的根目录文件夹下面有三个跟CocoaPods相关的文件(文件夹):Podfile,Podfile.lock和Pods

这时候,打开终端,进入项目所在的根目录,也就是和Podfile在同一目录下,输入以下命令(由于已经有Podfile,所以不需要再创建Podfile):

$pod update

执行完后,再回到工程根目录文件夹看一看,会看到多了一个文件.xcworkspace, 最后就点击该文件打开项目即可;