2017可用的CocoaPods安装教程

CocoaPods是什么？

当你开发iOS应用时，会经常使用到很多第三方开源类库，比如JSONKit，AFNetWorking等等。可能某个类库又用到其他类库，所以要使用它，必须得另外下载其他类库，而其他类库又用到其他类库，“子子孙孙无穷尽也”，这也许是比较特殊的情况。总之小编的意思就是，手动一个个去下载所需类库十分麻烦。另外一种常见情况是，你项目中用到的类库有更新，你必须得重新下载新版本，重新加入到项目中，十分麻烦。如果能有什么工具能解决这些恼人的问题，那将“善莫大焉”。所以，你需要 CocoaPods。

CocoaPods应该是iOS最常用最有名的类库管理工具了，上述两个烦人的问题，通过CocoaPods，只需要一行命令就可以完全解决，当然前提是你必须正确设置它。重要的是，绝大部分有名的开源类库，都支持CocoaPods。所以，作为iOS程序员的我们，掌握CocoaPods的使用是必不可少的基本技能了。

如何下载和安装CocoaPods？

• 第一步：安装ruby

不能一上来就换ruby源，虽然mac自带了ruby，但是版本一般比较低，如果不进行更新会导致版本依赖问题。

这里使用rvm来管理ruby，它允许共存多个ruby。RVM：Ruby Version Manager，Ruby版本管理器，包括Ruby的版本管理和Gem库管理。

通过以下命令来安装rvm：

$ curl -L get.rvm.io | bash -s stable  
$ source ~/.bashrc  
$ source ~/.bash_profile  

完成后就可以通过以下命令来查看rvm是否安装成功：

rvm -v  

然后就可以用rvm来安装或升级Ruby了，首先查看一下Ruby的版本：

MacBook-Air:~ xxxxx$ rvm list known
# MRI Rubies
[ruby-]1.8.6[-p420]
[ruby-]1.8.7[-head] # security released on head
[ruby-]1.9.1[-p431]
[ruby-]1.9.2[-p330]
[ruby-]1.9.3[-p551]
[ruby-]2.0.0[-p648]
[ruby-]2.1[.10]
[ruby-]2.2[.6]
[ruby-]2.3[.3]
[ruby-]2.4[.0]
ruby-head

可以看到当前的最新版本，然后通过以下命令来安装它：

rvm install 2.4  

安装好后将它设为默认版本：

rvm use 2.4 --default  

• 第二步：更改ruby源

升级好最新的ruby之后就可以更改ruby源了。

首先移除原有的墙外的源：

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

然后添加目前最新的由ruby官方中国维护的源：

gem sources -a https://gems.ruby-china.org/ 

然后确保当前只有这么一个源：

MacBook-Pro:~ xxxxx$ gem sources -l  
*** CURRENT SOURCES ***  
  
https://gems.ruby-china.org/ 

然后进行ruby的组件更新：

sudo gem update --system  

以上是多数网上比较权威的步骤，如果你跟着弄下来没有问题就没有问题了。

我跟着做下来的时候在update里一直会报这样一个错误：

ERROR:  While executing gem ... (OpenSSL::SSL::SSLError)  
    hostname "upyun.gems.ruby-china.org" does not match the server certificate 

最后各种尝试。用以下方法成功继续下去，如果你也有同样的情况可以尝试以下。
先把刚添加的源去掉，在重新添加一个源，把原地址最后的斜杠去掉：

gem sources --remove https://gems.ruby-china.org/  
gem sources -a https://gems.ruby-china.org 

• 第三步：安装CocoaPods

sudo gem install -n /usr/local/bin cocoapods  
sudo xcode-select --switch /Applications/Xcode.app 

在终端输入如下命令来完成安装：

pod setup  

这一步需要些时间，耐心等就是了。
如果安装失败，~/.cocoapods里面是空的，就需要重新setup

pod repo remove master  
pod setup  

最后如果出现Setup completed则说明安装完成了。

• 第四步：创建Podfile

  1、新建工程，并cd到工程目录
  2、新建Podfile文件

  vim Podfile
  

  3、按 i （英文输入状态下）进入编辑状态
  4、输入相应的第三方和版本，比如：

  platform:ios,'8.0'  
  target '你的项目名称' do  
  pod '类库名称'  
  end  
  

  为了确定第三方开源类库是否支持CocoaPods，可以用CocoaPods的搜索功能验证一下。在终端中输入：

   $ pod search 类库名称
  

  5、编辑好，先按esc键，再输入:wq（英文输入状态下）保存退出

  6、导入第三方库

   pod install
  

  7、打开后缀为.xcworkspace的工程文件，以后编码也是在此文件中进行操作。

  8、在需要使用第三方库的时候，导入头文件即可，比如：#import <AFNetworking.h>

原文链接