CocoaPods安装和使用教程

CocoaPods是什么？

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

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

如何下载和安装CocoaPods？

在安装CocoaPods之前，首先要在本地安装好Ruby环境。至于如何在Mac中安装好Ruby环境，请google一下，本文不再涉及。

假如你在本地已经安装好Ruby环境，那么下载和安装CocoaPods将十分简单，只需要一行命令。在Terminator（也就是终端）中输入以下命令（注意，本文所有命令都是在终端中输入并运行的。什么，你不知道什么是终端？那请小编吃饭，小编告诉你）：

sudo gem install cocoapods

但是，且慢。如果你在天朝，在终端中敲入这个命令之后，会发现半天没有任何反应。原因无他，因为那堵墙阻挡了cocoapods.org。（你会问，我靠，这都要墙！是的，小编也纳闷。）

但是，是的，又但是（不过是个可喜的“但是”）。我们可以用淘宝的Ruby镜像来访问cocoapods。按照下面的顺序在终端中敲入依次敲入命令：

$ gem sources --remove https://rubygems.org/
        //等有反应之后再敲入以下命令
        $ gem sources -a http://ruby.taobao.org/

为了验证你的Ruby镜像是并且仅是taobao，可以用以下命令查看：

$ gem sources -l

只有在终端中出现下面文字才表明你上面的命令是成功的：

*** CURRENT SOURCES ***

        http://ruby.taobao.org/

这时候，你再次在终端中运行：

$ sudo gem install cocoapods

等上十几秒钟，CocoaPods就可以在你本地下载并且安装好了，不再需要其他设置。

此处讲解的是macOS 10.11 以上的版本的Cocoapods安装

1. 准备工作

2. 打开终端

3. 输入命令，安装Cocoapods：

macOS 10.11以上，sudo gem install cocoapods 命令是不生效的，因为10.11把cocoapods直接干掉了。
所以，请输入命令：

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

4. 输入密码，安装成功后。接着执行如下命令，设置cocoapods的环境：

pod setup

5. 随后，会停留在 Setting up CocoaPods master repo 很长一段时间

6. 等待的结果就是：要么成功，要么失败。不过，一般会有如下错误：

[!] /usr/bin/git clone https://github.com/CocoaPods/Specs.git master

 Cloning into 'master'...
error: RPC failed; curl 56 SSLRead() return error -36
fatal: The remote end hung up unexpectedly
fatal: early EOF
fatal: index-pack failed

7. 淡定，出现问题，解决就是。输入如下命令：

cd ~/.cocoapods/repos
git clone https://github.com/CocoaPods/Specs.git master

8. 随后，看到这样的命令在跑：

Ps:这里需要等待好久，而且还会失败很多次。

Cloning into 'master'...
remote: Counting objects: 805011, done.
remote: Compressing objects: 100% (46/46), done.
Receiving objects:  96% (779053/805011), 311.26 MiB | 34.00 KiB/s

下载完毕后，会在上面的代码后面多一句在跑：

Resolving deltas:  37% (128437/346438)

整体是这样的：

Cloning into 'master'...
remote: Counting objects: 805011, done.
remote: Compressing objects: 100% (46/46), done.
remote: Total 805011 (delta 18), reused 0 (delta 0), pack-reused 804963
Receiving objects: 100% (805011/805011), 317.05 MiB | 48.00 KiB/s, done.
Resolving deltas:  69% (241794/346438)

完成后是这样的：

Cloning into 'master'...
remote: Counting objects: 805011, done.
remote: Compressing objects: 100% (46/46), done.
remote: Total 805011 (delta 18), reused 0 (delta 0), pack-reused 804963
Receiving objects: 100% (805011/805011), 317.05 MiB | 48.00 KiB/s, done.
Resolving deltas: 100% (346438/346438), done.
Checking connectivity... done.
Checking out files: 100% (105649/105649), done.

9. 完成后，输入命令，测试是否安装成功：

pod serach YYModel

10. 如果未成功，则是如下结果：

Cloning into 'master'...
remote: Counting objects: 804705, done.
remote: Compressing objects: 100% (19/19), done.
error: RPC failed; curl 56 SSLRead() return error -36 50.00 KiB/s
fatal: The remote end hung up unexpectedly
fatal: early EOF
fatal: index-pack failed

11. 失败的进行后续的操作，输入命令：

rm -fr ~/.cocoapods/repos/master

12. 再尝试：

pod setup

13. 它需要一点时间来完成，你等就是了。

如果安装失败 ~/.cocoapods 里面是空的，那就再重新setup命令：

pod repo remove master 
pod setup

14. 完毕之后 这个文件夹 大概有 好几百M，需要花费比较久时间，请耐心等待。

到此为止，你已经成功安装了CocoaPods。

15. 测试Cocoapods，命令行：

pod search YYModel

如何使用pod

16.使用步骤

①. 创建一个Demo
②. 打开终端，输入：cd空格，然后把项目文件夹拖入终端内
③. 在终端中输入ls，查看目录结构
④. 开始写podfile
在终端中输入以下命令：

//新建一个podfile文件
touch podfile​
//使用xcode打开文件
open -a xcode podfile​

//查找自己需要的第三方库，比如：AFNetworking
pod search AFNetworking​

把pod ‘AFNetworking’, ‘~> 3.1.0’复制下来
然后,在刚才打开的podfile文件中写:

platform :ios, '7.0'
target 'cocoaTest' do
pod 'AFNetworking', '~> 3.1.0'
pod 'YYModel', '~> 1.0.4'
end
//platform 的意思是系统支持的最低版本
//target是你的工程名
//do开始  end结束

补充 如果是Swift中使用Cocoapods，则需要这样写：

platform :ios, '8.0'
target 'TestCharts' do
use_frameworks!
pod 'Charts'
end

use_frameworks 选项是告诉 CocoaPods 使用 framework 而不是静态库。这在 Swift 项目中是必选。
我们添加的那行（pod ‘Charts’）是让 CocoaPods 知道我们要用 Charts。

⑤. 在终端输入命令：
pod search退出的命令是：:wq

//将第三方库导入自己的工程
pod install

⑥. 完成后，打开工程
⑦. 引入头文件注意事项：