前言

目前大多数iOS开发者，在开发的过程中都会用到三方库，三方库对于提高开发效率，节约时间成本具有重要意义。对于如何方便的管理三方库，如新功能的添加，已知Bug的修护，我们如何及时update和remove有着重要意义。CocoaPods是ios开发平台一个非常流行的第三方库管理工具。因此使用CocoaPods来帮助我们管理这些库，将大大有利于我们开发者。

CocoaPods的工作原理类似于将github平台上的第三方库clone到你的项目工程目录中，再直接将这些库的链接添加到你的工程中。并且之后你也可以通过简单的命令对这些库进行更新。如果大家想深刻的了解CocoaPods组件，这儿有一篇文章可以推荐：深入理解 CocoaPods

下面是用Xmind工具做的CocoaPods思维导图，对CocoaPods的环境配置，安装，使用，更新做了系统的总结。

CocoaPods安装及使用大全.png

环境配置

CocoaPods安装和使用前提要有Ruby环境的匹配支持(Mac系统默认是安装了Ruby，但是一般都会提示版本过低，因为每次Mac系统升级的时候Ruby环境不会自动升级的)

• 安装或更新Ruby环境

ruby -v  // 查看当前系统ruby版本

Snip20170720_31.png

以上截图看出Ruby版本是:2.0.0 时间：2015-12-16,版本过低，需要更新Ruby环境。目前Ruby比较快的更新方式是基于rvm(Ruby版本管理控制器)去更新，你可以选择你想要更新的Ruby版本。

• rvm安装或更新

rvm -v  // 查看当前系统rvm版本

Snip20170720_32.png

以上截图说明当前系统未安装rvm,下面是rvm安装命令

curl -L get.rvm.io | bash -s stable
source ~/.rvm/scripts/rvm
rvm -v     // rvm安装成功，查看版本
rvm list known      // 列出所有Ruby版本
rvm install 2.4.0    // 安装所需版本

Snip20170720_29.png

以上是安装rvm和Ruby版本截图

Snip20170720_33.png

以上是安装Ruby2.4.0版本的截图，时间有点长，注意红色标记部分，当前Mac系统，Ruby安装版本，密码输入等注意事项。

安装

• 查看是否已经安装CocoaPods

pod  --version  

Snip20170720_36.png

以上截图表明暂无pod 版本号，没有安装pod

• 安装CocoaPods

sudo gem install cocoapods

执行以上命令如果超时，表明你此次没有绕过GFW(防火墙)，可以选择VPN进行安装，或者选择国内镜像文件源安装。

Ruby 官网：https://rubygems.org/     // 可能超时
ruby 镜像 - taobao：https://ruby.taobao.org/
ruby 镜像 - china：https://gems.ruby-china.org/
ruby 镜像 - 阿里云：http://rubygems-china.oss.aliyuncs.com  // 笔者当前用的阿里云

第一步：查看当前系统ruby源

gem sources -l

Snip20170720_40.png

以上截图ruby源有两个，默认是官方的，后面的我自己安装的阿里云镜像。

第二步：修改官方ruby源

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

第三步：添加国内ruby源镜像

gem sources -a http://rubygems-china.oss.aliyuncs.com

好啦，上面的三步走成功之后，你可以终端再次执行 gem sources -l 命令，你会发现Ruby源变成了你刚添加的阿里云Ruby镜像。

第四步：安装CocoaPods

sudo gem install cocoapods

CocoaPods安装很快的，不出意外你会最后看到终端输出 gems installed ，下图是安装成功的信息。

Snip20170721_41.png

当然，你可以再次执行pod --version 命令，看看所安装的CocoaPods版本。

pod  --version    // 查看当前CocoaPods版本

Snip20170721_43.png

使用

好啦，CocoaPods已经安装完毕，现在我们一起来使用CocoaPods导入三方库吧，笔者以Masonry为例，按照规范，此处也分了几个步骤：

• 检查三方库是否支持CocoaPods导入(以Masonry为例)

pod search Masonry

从下面截图可以看出CocoaPods支持管理Masonry，以及Masonry的各个版本信息。
(此刻为了后续文章讲解CocoaPods对三方库的升级，故意安装低版本的Masonry，实际开发中一般是选择最新版本的三方库)

• 新建Xcode项目
  快捷键：command + shift + N (新建一个project),笔者项目命名为ZhengLianPay,打开终端进入项目文件夹。

cd  /ZhengLianPay

• 新建Podfile文件

vim Podfile

现在终端进入编辑Podfile文件模式，输入以下格式内容：

platform :ios, '8.0'

target 'ZhengLianPay' do
pod 'AFNetworking', '~> 3.0'
pod 'SDWebImage', '~> 3.8.1'
pod 'MJRefresh', '~> 3.1.12'
pod 'Masonry', '~> 1.0.2'
pod 'PNChart', '~> 0.8.9'
pod 'SloppySwiper', '~> 0.5'
pod 'YYModel', '~> 1.0.4'
pod 'SVProgressHUD', '~> 2.1.2'
pod 'YYCache', '~> 1.0.4'
end

最后退出编辑模式(按住ESC),保存Podfile文件(输入:wq)，此时需要安装的三方库文件配置完毕

• 安装命令

pod install

• 成功信息

[!] Please close any current Xcode sessions and use `ZhengLianPay.xcworkspace` for this project from now on.
Sending stats
Pod installation complete! There is 9 dependency from the Podfile and 1 total pod installed.

以下是安装成功之后，项目截图。

Snip20170823_6.png

这样的话，你就可以很方便的使用以上安装的三方库，提高项目的开发效率，节约开发成本。

更新

三方库的更新一般是在该库完善功能，修护bug，新增API等的情况下去更新，更新库也是比较简单的，先查看库的最新版本，现在以Masonry为例，终端执行pod search Masonry命令，你会看见最新的版本号，和Podfile中的版本号对比，如果现在的版本高于已安装的版本，此刻可以进行更新操作，直接修改Podfile文件中的Masonry版本号，保存。打开终端，进入项目目录，执行pod update命令，最后你会看见安装完成的信息。

• 更新命令

cd /ZhengLianPay     // 进入项目目录 (也可以直接打开项目中的Podfile文件进行编辑保存)
vim Podfile                  // 终端打开Podfile文件
platform :ios, '8.0' pod 'Masonry', '~> 1.0.3'     //编辑最新版本号，并保存
pod update     //最后更新命令

最后更新成功信息

Installing Masonry 1.0.3 (was 1.0.2)   //括号是更新前版本号

最后

哈哈，终于到最后啦，我们再一次做一下简单的总结，希望大家能够认真的看一下文章开头的那张CocoaPods思维导图，这是我自己查资料，实践总结的，很实用。

• CocoaPods终极总结

> 1 Ruby 环境           $ruby -v
> 2 CocoaPods安装    
      是否安装：pod  —version  
      安装：sudo gem install cocoa pods 最后的安装信息(gems installed)
> 3 使用CocoaPods
      3.1 :xcode新建工程 ZhengLianPay
      3.2 ：终端指定目录, cd  /ZhengLianPay（就是项目的文件夹）
      3.3 : vim Podfile  创建Podfile文件
      3.4 ：编辑Podfile描述文件，设置要下载的第三方库
**********************************************
platform :ios, '8.0'
target ‘ ZhengLianPay’ do
pod 'AFNetworking', '~> 3.0'
pod 'SDWebImage', '~> 3.8.1'
pod 'MJRefresh', '~> 3.1.12'
pod 'Masonry', '~> 1.0.2'
pod 'PNChart', '~> 0.8.9'
pod 'SloppySwiper', '~> 0.5'
pod 'YYModel', '~> 1.0.4'
pod 'SVProgressHUD', '~> 2.1.2'
pod 'YYCache', '~> 1.0.4'
end
*********************************************
      3.5 ：开始安装：pod install  (注意查看安装信息，自动产生Podfile.lock文件)   —> 可以使用了。

> 4 更新   $cd /ZhengLianPay
               $vim Podfile
                 platform :ios, ‘8.0'pod 'Masonry', '~> 1.0.3'
         $pod update
         信息：Installing Masonry 1.0.3(was 1.0.2)

-END-

CocoaPods的安装和使用就写到这儿吧，希望这篇文章能帮助初学者初识CocoaPods，看文章和学习的过程中如果有问题，恳请各路大神和同僚留言哦。下篇干货主要记录CocoaPods使用中的常见错误，以及冲突问题，粉我你就不会迷路哦，😆😆😆...