CocoaPods 使用

1. CocoaPods的安装步骤

在安装CocoaPods之前，首先要在本地安装好Ruby环境，默认情况下，Mac自带Ruby环境。因为Ruby的默认源rubygems.org使用的是亚马逊的云服务，在国内使用会被墙，所以需要更换一下Ruby的源。

1.1 首先打开终端，输入以下命令符检查Ruby源

$ gem sources - l

如果你的镜像地址是如下图1-1所示：

图1-1

那么就需要替换Ruby源。

1.2 替换Ruby源，输入以下命令符，删除目前的Ruby源

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

1.3 添加新的Ruby源，输入以下命令符：

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

之前使用的是以下这个

$ gem sources -a https://ruby.taobao.org/

但是这个已经不维护了，请查看相关信息。

1.4 添加新的Ruby源之后，可以查看是否替换成功

$ gem sources -l

成功就如图1-2所示：

图1-2

到这里就算已经成功配置完环境了，下一步就是安装了。

1.5 安装CocoaPods，继续在终端输入命令： 输入完命令后会要求输入用户密码

macOS 10.12以下使用的是

$ sudo gem install -n /usr/local/bin cocoapods

OS X 10.11以上使用的是

$ sudo gem install cocoapods

1.6 等待以上命令符执行完毕，继续输入以下命令：

$ pod setup

出现如图1-3所示：

图1-3

出现Setting up CocoaPods master repo 后会卡住一段时间，

可以在新开一个终端的窗口，输入以下的命令，查看下载文件的大小。

$ cd ~/.cocoapods

$ du -sh

下载完毕后，所占磁盘的大小在399M左右。下载过程需根据网络情况

1.7 下载成功，输入以下命令：

$ pod --version

可以看到安装成功cocoapods的版本。

1.8 如果遇到无法下载可能是Ruby版本较低，需要升级版本（请自行根据提示查找原因）

ERROR: Error installing cocoapods:

activesupport requires Ruby version >= 2.2.2.

---

终端输入：$gem update --system

Latest version currently installed. Aborting. 表示目前是最新版本

如果此时终端出现如下提示：

ERROR:While executing gem ... (Gem::FilePermissionError)

You don't have write permissions for the /Library/Ruby/Gems/2.0.0 directory.

这个是因为你没有权限去更新Ruby

这个时候你需要在终端使用如下命令：

$ sudo gem update --system

运行后如果出现一下提示表明已经更新成功：

这个时候表示Ruby升级完成。

cocoapods卸载重新安装

$ sudo gem uninstall cocoapods  //卸载

$ sudo gem install -n /usr/local/bin cocoapods  //安装

或者 $ sudo gem install cocoapods

cocoapods卸载重装的例子参考。如果升级已有的cocoapods，则输入以下命令：

$ sudo gem update cocoapods  //升级cocoapods

查看本地安装过的cocoapods相关东西，命令如下：

$ gem list --local | grep cocoapods

2. CocoaPods的使用

当CocoaPods安装完之后可以在输入一下命令开始添加第三方的框架了；该命令是查看AFNetworking
有哪些版本，pod search 第三方框架名称。

$ pod search AFNetworking

安装成功就会显示出相关的所有第三方开源类库。

2.1 怎么在项目中使用呢，首先需要在终端里面cd到项目文件夹里面，如下所示：

$ cd 项目文件夹路径    （可以直接把拖动项目文件夹到终端光标处，系统自动生成路径）

2.2 创建Podfile 文件

$ touch Podfile

2.3 编辑Podfile文件

$ vim Podfile

platform :ios, '8.0'      #用来设置所有第三方库所支持的iOS最低版本

target 'MyApp' do      #MyApp 就是你的项目名

pod 'AFNetworking', '~> 3.1.0'

pod 'SDWebImage', '~> 4.0.0'

end

12. 在编辑完后

按 esc, 然后按":"

这个时候输入wq 回车保存退出。

---

(版本号的规则：

'>1.0' 可以安装任何高于1.0的版本

'>=1.0' 可以安装任何高于或等于1.0的版本

'<1.0' 任何低于1.0的版本

'<=1.0' 任何低于或等于1.0的版本

'~>0.1' 任何高于或等于0.1的版本，但是不包含高于0.1的版本

'~>0' 任何版本，相当于不指定版本，默认采用最新版本号)

编辑Podfile文件之后， 按 i 可编辑 ，esc 退出编辑，:wq  可保存退出,:q 不保存退出。扩展Podfile语法参考

---

2.4 安装第三方开源类库

编辑Podfile文件之后,保存退出，然后终端输入命令：

$ pod install

2.5 更新第三方开源类库

以后需要添加、更新、删除某个第三方库，只要编写好Podfile文件，在终端输入：

$ pod update

之后运行就OK了。

如果升级某一个指定的第三方库，则输入以下命令：

$ pod update 第三方库名称

参考文章  Xcode 8.0和macOS 10.12以下安装CocoaPods的流程

参考文章  新版Cocoapods1.2.0简易教程

参考文章 Xcode 8.0安装CocoaPods

参考文章 Cocoapods安装步骤