在 Swift中安装 Cocoapods

文／CoderAO（作者）

原文链接：http://www.jianshu.com/p/6e5c0f78200a

著作权归作者所有，转载请联系作者获得授权，并标注“作者”。

一、什么是CocoaPods

CocoaPods是iOS项目的依赖管理工具，该项目源码在Github上管理。开发iOS项目不可避免地要使用第三方开源库，CocoaPods的出现使得我们可以节省设置和第三方开源库的时间。

在使用CocoaPods之前，开发项目需要用到第三方开源库的时候，我们需要

1.把开源库的源代码复制到项目中

2.添加一些依赖框架和动态库

3.设置-ObjC，-fno-objc-arc等参数

4.管理他们的更新

在使用CocoaPods后，我们只需要把用到的开源库放到一个名为Podfile的文件中，然后执行pod install.Cocoapods就会自动将这些第三方开源库的源码下载下来，并且为我们的工程设置好响应的系统依赖和编译参数。

二、CocoaPods的原理

CocoaPods的原理是将所有的依赖库都放到另一个名为Pods的项目中，然后让主项目依赖Pods项目，这样，源码管理工作都从主项目移到了Pods项目中。Pods项目最终会编译成一个名为libPods.a的文件，主项目只需要依赖这个.a文件即可。

三、CocoaPods的安装

CocoaPods可以方便地通过Mac自带的RubyGems安装。

打开Terminal，然后键入以下命令：

$ sudo gem install cocoapods

执行完这句如果报告以下错误：

ERROR:  Could not find a valid gem 'cocoapods' (>= 0), here is why:

Unable to download data fromhttps://rubygems.org/- Errno::ETIMEDOUT: Operation timed out - connect(2) (https://rubygems.org/latest_specs.4.8.gz)

ERROR:  Possible alternatives: cocoapods

这是因为ruby的软件源rubygems.org因为使用亚马逊的云服务，被我天朝屏蔽了，需要更新一下ruby的源，过程如下：

$ gem sources -l  (查看当前ruby的源)

$ gem sources --removehttps://rubygems.org/

$ gem sources -ahttps://ruby.taobao.org/

$ gem sources -l

如果gem太老，可以尝试用如下命令升级gem

$ sudo gem update --system

升级成功后会提示: RubyGems system software updated

然后重新执行安装下载命令

$ sudo gem install cocoapods

这时候应该没什么问题了

接下来进行安装，执行：

$ pod setup

Terminal会停留在 Setting up CocoaPods master repo 这个状态一段时间,是因为要进行下载安装,而且目录比较大,需要耐心等待一下.如果想加快速度,可使用cocoapods的镜像索引.（文章末尾附使用镜像索引的方法）

安装成功后,你会看到:

四、Cocoapods的使用

进入工程所在的目录（工程根目录）

执行命令 touch Podfile

这句是说新建一个名为Podfile的文件（不能写成别的名字，也可以自己在工程根目录里面直接新建）

然后对改文件进行编辑，执行命令 open -e Podfile

第一次执行这个命令,会有一个空白文件打开，可以先放在一边，

Podfile文件的格式应该如下：

platform :ios, ‘7.0’【swift中使用：use_frameworks!】

pod 'AMap2DMap', '~> 2.5.0'

pod 'AFNetworking', '~> 2.5.3'

pod 'SDWebImage', '~> 3.7.2'

需要注意的几点：platform那一行，ios三个字母都要小写，而且与前面的冒号之间不能有间隔，后面的版本号也可以不写，但是有些开源库对版本是有要求的，比如要在6.0以上才能运行，遇到这样的开源库就需要写上版本号。

platform下面就是Cocoapods需要集成的开源库，根据你的需要确定集成那些库。