CocoaPods 简介
每种语言发展到一个阶段，就会出现相应的依赖管理工具，例如 Java 语言的 Maven，nodejs 的 npm。随着 iOS 开发者的增多，业界也出现了为 iOS 程序提供依赖管理的工具，它的名字叫做：CocoaPods。
CocoaPods项目的源码 在 Github 上管理。该项目开始于 2011 年 8 月 12 日，经过多年发展，现在已经成为 iOS 开发事实上的依赖管理标准工具。开发 iOS 项目不可避免地要使用第三方开源库，CocoaPods 的出现使得我们可以节省设置和更新第三方开源库的时间。
在iOS开发时，使用了 24 个第三方开源库。在没有使用 CocoaPods 以前，我需要:
1.把这些第三方开源库的源代码文件复制到项目中，或者设置成 git 的 submodule。
2/对于这些开源库通常需要依赖系统的一些 framework，我需要手工地将这些 framework 分别增加到项目依赖中，比如通常情况下，一个网络库就需要增加以下 framework: CFNetwork, SystemConfiguration, MobileCoreServices, CoreGraphics, zlib。
3.对于某些开源库，我还需要设置-licucore或者 -fno-objc-arc等编译参数
管理这些依赖包的更新。
这些体力活虽然简单，但毫无技术含量并且浪费时间。在使用 CocoaPods 之后，我只需要将用到的第三方开源库放到一个名为 Podfile 的文件中，然后执行pod install。
CocoaPods 就会自动将这些第三方开源库的源码下载下来，并且为我的工程设置好相应的系统依赖和编译参数。
安装
（1）、将Ruby 的软件源替换成国内的
ruby 的软件源（ https://rubygems.org ）使用的是亚马逊的云服务，所以自带的需要翻墙，但我们可以使用如下代码将官方的 ruby 源替换成国内淘宝的源（https://ruby.taobao.org/ ）或者是由 Ruby China 社区专注维护的这个源（https://gems.ruby-china.org/ ）。（我在镜像的时候开始用的是淘宝的，但会卡死，可能是不能用了，也可能是网速慢，在后面讲“坑”的时候会说）。在这我用的是Ruby China 社区专注维护的这个源（https://gems.ruby-china.org/）。
＊首先，执行以下命令删除原来的ruby源：
gem sources --remove https://rubygems.org/
然后下一步添加你找到的可用的镜像源
gem sources -a https://gems.ruby-china.org/
gem sources ／／验证新源是否替换成功
*** CURRENT SOURCES ***
https://gems.ruby-china.org
到此ruby 源替已经换成国内的源
其中可能遇到的坑：
1.之前写地址时，要注意https，gems，ruby-china的写法，有时会容易写成http，gem，ruby.china，导致出现莫名其妙的错误
2.如果出现Error fetching的错误，注意查查下对应地址是否可以用网页打开，如果不行，可能DNS地址被劫持了，替换DNS为8.8.8.8/8.8.4.4这两组GoogleDNS，另外可以断电几分钟重启下路由器
（2）安装
很简单的一句话
sudo gem install -n /usr/local/bin cocoapods
如果gem出现错误
Unable to resolve dependencies
那么就输入
sudo gem update --system
然后
pod setup
在此步骤时间漫长，又最容易出问题，众多问题亲历见具体案例
创建文件 Podfile
在终端中进入（cd命令）你项目所在目录，然后在当前目录下，创建Podfile，运行：
touch profile
然后在Podfile文件中输入以下文字：
platform :ios, '7.0'
pod "AFNetworking", "~> 2.0"
这时候，你会发现你的项目目录中，出现一个名字为Podfile的文件，而且文件内容就是你刚刚输入的内容。注意，Podfile文件应该和你的工程文件.xcodeproj在同一个目录下。
这时候，你就可以利用CocoPods下载AFNetworking类库了。还是在终端中的当前项目目录下，运行以下命令：
cd "your project home"
pod install
现在，你的所有第三方库都已经下载完成并且设置好了编译参数和依赖，你只需要记住如下 2 点即可：
使用 CocoaPods 生成的 .xcworkspace 文件来打开工程，而不是以前的 .xcodeproj 文件。
每次更改了 Podfile 文件，你需要重新执行一次pod update命令。
查找第三方库
你如果不知道 cocoaPods 管理的库中，是否有你想要的库，那么你可以通过 pod search 命令进行查找，以下是我用 pod search json 查找到的所有可用的库：
$ pod search json
-> AnyJSON (0.0.1)
Encode / Decode JSON by any means possible.
- Homepage: https://github.com/mattt/AnyJSON
- Source: https://github.com/mattt/AnyJSON.git
- Versions: 0.0.1 [master repo]
-> JSONKit (1.5pre)
A Very High Performance Objective-C JSON Library.
- Homepage: https://github.com/johnezang/JSONKit
- Source: git://github.com/johnezang/JSONKit.git
- Versions: 1.5pre, 1.4 [master repo]
// ... 以下省略若干行
关于 Podfile.lock
当你执行pod install之后，除了 Podfile 外，CocoaPods 还会生成一个名为Podfile.lock的文件，Podfile.lock 应该加入到版本控制里面，不应该把这个文件加入到.gitignore中。因为Podfile.lock会锁定当前各依赖库的版本，之后如果多次执行pod install 不会更改版本，要pod update才会改Podfile.lock了。这样多人协作的时候，可以防止第三方库升级时造成大家各自的第三方库版本不一致。
CocoaPods 的这篇官方文档也在What is a Podfile.lock一节中介绍了Podfile.lock的作用，并且指出：
This file should always be kept under version control.
如果 pod update / pod install 命令执行过慢
（首次运行的时候不要）执行pod install还是pod update都卡在了Analyzing dependencies不动原因在于当执行以上两个命令的时候会升级CocoaPods的spec仓库，加一个参数可以省略这一步，然后速度就会提升不少。
加参数的命令如下：
pod install --no-repo-update
pod update --no-repo-update
生成第三方库的帮助文档
如果你想让 CococaPods 帮你生成第三方库的帮助文档，并集成到 Xcode 中，那么用 brew 安装 appledoc 即可：
brew install appledoc
关于 appledoc，在《使用 Objective-C 的文档生成工具:appledoc》 中有专门介绍。它最大的优点是可以将帮助文档集成到 Xcode 中，这样你在敲代码的时候，按住 opt 键单击类名或方法名，就可以显示出相应的帮助文档。
pod install 和 pod update
pod install一般是你第一次想要为项目添加pod的时候使用的，它同样也使用在你为Podfile文件添加或移除pod库的时候。
每次pod install命令运行的时候，pod install会为每一个它安装的pod库在Podfile.lock文件中写入其版本号。Podfile.lock文件追踪每一个安装的pod库的版本号，并锁定这些版本号。
当你运行pod install是，它将只解决不在Podfile.lock中的pod库依赖关系
对于在Podfile.lock文件中的pod库，pod install会只下载Podfile.lock文件中指定的版本，而不会去检查这个库是否有更新的版本。
对于不在Podfile.lock文件中的pod库，pod install会搜索这个pod库在Podfile文件中指定的版本
pod update
当你运行了pod update PODNAME命令，CocoaPods会在不考虑Podfile.lock中版本的情况下试着去查找PODNAME的最新版本。pod update PODNAME命令会将相应的pod更新到最新的版本（新版本仍然遵守你在Podfile中做的限制）
唯一能够保证团队中所有的成员都用使用pod库的相同版本的方法就是使用Podfile.lock并且正确的使用pod install和pod update
原理
大概研究了一下 CocoaPods 的原理，它是将所有的依赖库都放到另一个名为 Pods 项目中，然后让主项目依赖 Pods 项目，这样，源码管理工作都从主项目移到了 Pods 项目中。发现的一些技术细节有：
Pods 项目最终会编译成一个名为 libPods.a 的文件，主项目只需要依赖这个 .a 文件即可。
对于资源文件，CocoaPods 提供了一个名为 Pods-resources.sh 的 bash 脚本，该脚本在每次项目编译的时候都会执行，将第三方库的各种资源文件复制到目标目录中。
CocoaPods 通过一个名为 Pods.xcconfig 的文件来在编译时设置所有的依赖和参数。
