1、Ruby环境搭建
下载安装CocoaPods需要Ruby环境 ，Mac OS X 本身自带Ruby，
安装 RVM
额外解释：RVM: （全称Ruby Version Manager）, Ruby版本管理器，包括Ruby的版本管理和Gem库管理。Gem是一个管理Ruby库和程序的标准包，它通过Ruby Gem（如 http://rubygems.org/ ）源来查找、安装、升级和卸载软件包，非常的便捷。
$ curl -L get.rvm.io | bash -s stable
测试是否安装正常：
rvm -v
可以使用RVM升级Ruby。
查看当前ruby版本：
$ ruby -v
ruby 1.8.7 //结果显示当前已安装ruby版本为1.8.7
列出已知的ruby版本：
$ rvm list known
安装ruby 2.3.0p0 ： //注：可根据需要安装最新版本
$ rvm install 2.3.0p0
2、CocoaPods镜像源的更换
当在项目中使用了多个第三方开源库。在没有使用 CocoaPods 以前，我们需要:
1）把这些第三方开源库的源代码文件复制到项目中，或者设置成 git 的 submodule；
2）对于这些开源库其通常需要依赖系统的一些 framework，我们需要手工地将这些 framework 分别增加到项目依赖中，比如通常情况下，一个网络库就需要增加以下 framework: CFNetwork, SystemConfiguration, MobileCoreServices, CoreGraphics, zlib；
3）对于某些开源库，我们还需要设置-licucore或者 -fno-objc-arc等编译参数；
4）管理这些依赖包的更新。
在使用 CocoaPods 之后，我只需要将用到的第三方开源库放到一个名为 Podfile 的文件中，然后执行pod install。CocoaPods 就会自动将这些第三方开源库的源码下载下来，并且为我们的工程设置好相应的系统依赖和编译参数。
ruby 的软件源 https://rubygems.org 因为使用的是亚马逊的云服务，所以被墙了，需要更新一下 ruby 的源，使用如下代码将官方的 ruby 源替换成国内淘宝的源：
gem sources --remove https://rubygems.org/
gem sources -a https://ruby.taobao.org/
gem sources -l
显示如下则表示替换成功：
*** CURRENT SOURCES ***
https://ruby.taobao.org/
所有的项目的 Podspec 文件都托管在https://github.com/CocoaPods/Specs。第一次执行pod setup时，CocoaPods 会将这些podspec索引文件更新到本地的 ~/.cocoapods/目录下，这个索引文件比较大，有 80M 左右。所以第一次更新时会非常慢。
一个叫 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
可以使用 gitcafe 镜像：https://gitcafe.com/akuandev/Specs.git
或者使用oschina 上的镜像：http://git.oschina.net/akuandev/Specs.git
3、下载安装CocoaPods
cd到项目总目录（注意：包含PodTest文件夹、PodTest.xcodeproj、PodTestTest的那个总目录）终端输入：
sudo gem install cocoapods
pod setup
说明：pod setup在执行时，会输出Setting up CocoaPods master repo，但是会等待比较久的时间。这步其实是 Cocoapods 将podspec索引文件下载到 ~/.cocoapods目录下，如果你等太久，可以试着 cd 到那个目录，用du -sh *来查看下载进度。
4、 建立Podfile文件
cd到项目总目录，终端输入 ：
vim Podfile
输入 i，进入编辑模式，输入：
[source ‘https://github.com/CocoaPods/Specs.Git’]
platform :ios, ‘7.0’
[use_frameworks!]
target “你的项目文件名” do
pod 'MBProgressHUD', '~> 0.8'
end
注：以上“[]”标注的为可选项。
按Esc, 再输入:wq 保存退出。终端输入：
pod install
现在，你的所有第三方库都已经下载完成并且设置好了编译参数和依赖，你只需要记住如下 2 点即可：
1）使用 CocoaPods 生成的 .xcworkspace 文件来打开工程，而不是以前的 .xcodeproj 文件。
2）每次更改了 Podfile 文件，你需要重新执行一次pod update命令。
5、查找第三方库
你如果不知道 cocoaPods 管理的库中，是否有你想要的库，那么你可以通过 pod search 命令进行查找，以下示例为：用 pod search json 查找所有可用的json库：
$ pod search json
6、CocoaPods 的原理
它是将所有的依赖库都放到另一个名为 Pods 项目中，然后让主项目依赖 Pods 项目，这样，源码管理工作都从主项目移到了 Pods 项目中。发现的一些技术细节有：
1）Pods 项目最终会编译成一个名为 libPods.a 的文件，主项目只需要依赖这个 .a 文件即可。
2）对于资源文件，CocoaPods 提供了一个名为 Pods-resources.sh 的 bash 脚本，该脚本在每次项目编译的时候都会执行，将第三方库的各种资源文件复制到目标目录中。
3）CocoaPods 通过一个名为 Pods.xcconfig 的文件来在编译时设置所有的依赖和参数。
7、CocoaPods常见问题
1）安装cocoapods提示无权限问题：
Errno::EPERM - Operation not permitted Solution, fix for Cocoapods error on El Capitan 10.11:
解决方案：
sudo gem install -n /usr/local/bin GEM_NAME_HERE
示例：
sudo gem install -n /usr/local/bin cocoapods
2）执行pod install或者pod update时会升级CocoaPods的spec仓库，导致卡在Analyzing dependencies不动，CocoaPods 在执行pod install和pod update时，会默认先更新一次podspec索引。使用—no-repo-update参数可以禁止其做索引更新操作，以下命令参数可忽略这一步：
pod install --verbose --no-repo-update
pod update --verbose --no-repo-update
3) 执行pod setup时提示如下错误：
[!] /usr/bin/Git clone 'https://github.com/CocoaPods/Specs.git' master
Cloning into 'master'...
error: RPC failed; result=56, HTTP code = 200
fatal: The remote end hung up unexpectedly
原因：
The problem is most likely because your git buffer is too low.
You will need to increase Git’s HTTP buffer by setting the git config var “http.postBuffer” to 524288000.
解决方案：
git config --global http.postBuffer 524288000
4）清理当前Pod目录：
sudo rm -rf ~/.cocoapods
5）搜索不到第三方库：
rm ~/Library/Caches/CocoaPods/search_index.json
6）上传SVN：
把源工程上传SVN的时候，记得需要忽略两个文件Pods、Podfile.lock，但不能忽略*.a。Checkout下来后，再进行pod install操作，就可以正常使用了。
关于Podfile.lock：
当你执行pod install之后，除了 Podfile 外，CocoaPods 还会生成一个名为Podfile.lock的文件，Podfile.lock 应该加入到版本控制里面，不应该把这个文件加入到.gitignore中。因为Podfile.lock会锁定当前各依赖库的版本，之后如果多次执行pod install 不会更改版本，要pod update才会改Podfile.lock了。这样多人协作的时候，可以防止第三方库升级时造成大家各自的第三方库版本不一致。
7）生成第三方库的帮助文档
如果你想让 CococaPods 帮你生成第三方库的帮助文档，并集成到 Xcode 中，那么用 brew 安装 appledoc 即可：
brew install appledoc
它最大的优点是可以将帮助文档集成到 Xcode 中，这样你在敲代码的时候，按住 opt 键单击类名或方法名，就可以显示出相应的帮助文档。
8）用CocoaPods 完成第三方库的安装后，在需要的地方导入#import时无提示：
解决方案：
选择Target -> Build Settings菜单 search Paths下，找到”User Header Search Paths”设置项，双击后面的空白区域，单击+号，输入$(PODS_ROOT) 然后再选择recursive即可。如下图所示：
9）iOS 删除已经配置的类库和从项目中移除整个CocoaPods（不是在终端卸载）
删除项目中已经配置的类库：
打开Podfile文件，假设其文件内容如下：
pod ‘AFNetworking’
pod ‘JSONKit’
现在要删除JSONKit。只需修改Podfile文件为如下即可：
pod ‘AFNetworking’
再重新执行：
pod update
在项目中移除CocoaPods：
1.删除工程文件夹下的Podfile、Podfile.lock和Pods文件夹。
2.删除xcworkspace文件。
3.打开xcodeproj文件，删除项目中的Pods文件夹及Pods.xcconfig引用和libpods.a：
4.打开Build Phases选项，删除Check Pods Manifest.lock和Copy Pods Resources，以及Embeded Pods Frameworks：
10）如何正确编译运行一个包含CocoPods类库的项目
cd进入项目所在目录：
$ pod update
运行.xcworkspace即可。
网友评论