最近在使用cocoapods时，因为没有很系统的了解，导致要频繁的去网上查阅各种资料，结果很多资料都已经过时，或是使用后频繁报错，最终结果就是要踩很多的坑，费时费力。碰壁过后，决定把资源好好整合一下，查漏补缺。

首先，关于cocoapods是啥，为什么要使用？使用有什么好处，可以点击查看这篇文章，里面说的很详细：细聊 Cocoapods 与 Xcode 工程配置。我这就不啰嗦了。

CocoaPods 是用 gem ruby 实现的，要想使用它首先需要有 gem ruby 的环境。且 MAC 的 OS X系统默认已经可以运行 ruby 。但是当 gem ruby 包版本低于 2.2.2 时，安装 CocoaPods 会报错；为防止 gem ruby 包环境过低，建议先升级 gem ruby 环境，建议升级到 2.6.x 版本以上。（此步操作可以查看A-2步骤的其他指令）

故其先后步骤是：安装RVM，再安装ruby环境，再安装cocoapods.

第一步，安装cocoapods，安装之前，首先需要安装RVM和检查ruby版本环境。（以下命令全在终端执行）

A-1安装RVM:

a步骤、rvm -v    //检查当前 rvm 环境，若不存在，执行b步骤。若存在，直接跳至A-2.

b步骤、curl -L https://get.rvm.io | bash -s stable   //安装RVM环境

              source ~/.rvm/scripts/rvm          //载入RVM环境

c步骤、rvm -v    //再次检查当前 rvm 环境。

A-2安装ruby版本环境（用 rvm 安装 ruby 环境；）

a步骤、  rvm list known                 //安装ruby,查询已知的 ruby 环境。 

b步骤、 rvm install 2.3.0                //指定 ruby 版本进行更新（ 此处按照 ruby 2.3.0 版本进行更新 ---更新时在  安装homebrew` 安装依赖包）。

c步骤、rvm list          //查询ruby是否已经安装好的。

ruby其他相关指令：

rvm remove 1.9.2      //卸载一个已安装版本：

sudo gem -v        //检查 gemruby 版本号

sudo gem update --system          //更新 gemruby 版本号

A-3更换镜像源（需要来修改更换源国内镜像源，taobao源 (已经停止维护了)切换至ruby-china源

a步骤、gem sources -l         //检查 ruby源

b步骤、 gem sources --remove https://rubygems.org/      //移除 ruby源

c步骤、gem sources --add https://gems.ruby-china.org    //替换 ruby-china源

d步骤、gem sources -l         //再次检查此时的 ruby 源

A-4安装CocoaPods.

a步骤、安装 CocoaPods.（若安装失败，执行C步骤）

OS X 10.11之前系统的安装 CocoaPods 指令： $ sudo gem install cocoa pods   

OS X 10.11以后系统的安装 CocoaPods 指令： $ sudo gem install -n /usr/local/bin cocoa pods

b步骤、下载过程中可新建一个终端，输入命令 cd ~/.cocoapods进入终端，输入命令du -sh *查看下载进度.

c步骤:(若a步骤安装失败，执行下列命令)

pod setup                  //更新pod,

sudo gem update --system          //更新gem到最新版本

ping github.com                //检查是否可以ping通github

pod repo list              //查看pob repo list

rm ~/Library/Caches/CocoaPods/search_index.json      //仍报错则输入

d步骤、通过搜索第三方框架，验证是否安装成功.

pod search 第三方库

第二部，cocoapods使用。

第一步：打开终端，在终端输入cd 按一下空格键， 然后把工程文件夹拖到终端内生成路径。

第二步：在终端输入ls，验证打开路径是否正确，对比一下文件夹目录是否正确。

第三步：在终端输入：vim Podfile  ，创建Podfile文件。

第四步：输入i,进入编辑模式，输入第三方库相关一些信息。官方版文档格式为（举例）：

platform :ios, '8.0'            //iOS版本

target '你的项目名称' do          //项目名称

pod 'AFNetworking', '~> 3.0'         //举例

end                //完成

第五步：编辑完后，按下esc键，退出编辑模式。再输如：wq,保存退出.

第六步：输入pod install ，对你所需要的第三方进行下载。

第七步：由Cocoapods生成的 .xcworkspace文件来打开工程，而不是使用以前的.xcodeproj文件。

注意：当执行pod install之后，除了Podfile，还会生成一个名为Podfile.lock的文件，它会锁定当前各依赖库的版本，之后即使多次执行pod install也不会更改版本，只有执行pod update才会改变Podfile.lock.在多人协作的时候，这样可以防止第三方库升级时候造成大家各自的第三方库版本不一致。所以在提交版本的时候不能把它落下，也不要添加到.gitignore中。

小窍门：

1、创建Podfile文件（在终端输入：touch Podfile），此时Podfile文件就生成了。

2、在终端输入： open -e Podfile），就可以在文本编辑器中对Podfile文件进行修改。

3、每次更改了Podfile文件，都需要重新执行一次pod update命令。

想详细了解安装流程的可以去看下这篇文章：2017最新安装cocoapods流程。

另外收集了一些针对错误、缺陷提供的解决办法。

问题1：执行pod install还是pod update都卡在了Analyzing dependencies不动。

解决办法：原因在于当执行以上两个命令的时候会升级CocoaPods的spec仓库，加一个参数可以省略这一步，然后速度就会提升不少。加参数的命令如下：                                              pod install --verbose --no-repo-update

pod update --verbose --no-repo-update

问题2：使用cocoaPods后，import导入时第三方库头文件没有提示。

解决办法：看这里

问题3：待继续补充。

最后，卸载cocoapods再重新安装。

1、 sudo gem uninstall cocoapods

2、sudo gem uninstall cocoapods-core

3、sudo rm -fr ~/.cocoapods/repos/master          //清除cocoapods缓存

4、sudo gem install -n /usr/local/bin cocoapods --pre    //重装cocoapods

以上，按照步骤来是比较速成的安装方法，不会四处碰壁，至于想弄清其中缘由，那还得自己亲身踩一下坑才会明白。我只是安装自己容易接受的方式做了一次搬运工。