Cocoapods 安装和使用

本文写于2016年9月，安装Cocoapods 用于iOS开发，可直接用Mac上的终端从GitHub上将第三方框架应用到工程中，接下来的安装配置基于上一篇文章《在Mac OS X上安装 Ruby运行环境》所配置的系统环境。

---

Cocoapods的安装

1.升级Ruby环境

若是Ruby没有安装，请参考 《在Mac OS X上安装 Ruby运行环境》。
gem是一种文件组织的包，基于ruby开发，通常的ruby的不少插件都由各类包提供。

注：如下代码区域，带有 $ 打头的表示须要在控制台（终端）下面执行（不包括 $ 符号），下一行为结果，不需码入。

$ sudo gem -v
$ sudo gem update --system

2.安装Cocoapods时咱们要访问cocoapods.org，用Ruby China的RubyGems镜像来代替，执行如下命令：

12月20日更新：RubyGems 镜像的管理工做已由淘宝转交 Ruby China 负责，https://ruby.taobao.org/ 更改成 https://gems.ruby-china.org/ 下面已作处理

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

为了验证你的Ruby镜像是而且仅是taobao，能够用如下命令查看：

$ gem sources -l

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

*** CURRENT SOURCES ***

https://gems.ruby-china.org/

3.1 安装Cocoapods,在终端输入命令:

注意：（Mac版本10.11以上，请直接跳到3.2）

$ sudo gem install cocoapods

3.2 Mac系统版本10.11以上，上面的命令不生效

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

4.安装：

//将 Cocoapods Specs repository 复制到你电脑上 ~/.cocoapods 目录下
pod setup

安装须要花费比较多时间，请耐心等待，到这里你已经成功安装了Cocoapods。

5.问题

(1)若是遇到以下问题：

移除原来的cocoapods：

$ sudo gem uninstall cocoapods  //交互时选择 y 

从新执行3和4步。

(2)若是安装失败 ~/.cocoapods 文件夹里面是空的，就须要从新setup，命令以下：

pod repo remove master  
pod setup

另附：

pod --version //查询cocoapods版本
sudo gem install cocoapods --pre //更新cocoapods版本

pod setup解决方案

1.访问 https://github.com/CocoaPods/...，而后将Specs项目fork到本身的github帐户上。
2.下载GitHub Desktop, 而后clone Specs项目。
3.将clone的Specs项目的文件夹更名为master，而后拖到/Users/用户名/.cocoapods/repos目录下。
4.运行pod setup

解释：pod setup的本质就是将https://github.com/CocoaPods/...上的Specs项目clone到/Users/用户名/.cocoapods/repos目录下。若此目录下已有Specs项目，则会将项目更新到最新的状态。因为Specs很大，容易致使pod setup失败。这时就须要咱们手动安装Specs。若直接从github上下载zip文件，因为缺乏git文件，会致使cocoa pods不使用。若用git clone，因为文件过大，容易致使失败。可是使用GitHub Desktop软件，则会提升clone的成功率，而且会给出clone的进度。

更新
可使用国内的镜像地址（https://coding.net/u/hging/p/...），直接clone到/Users/用户名/.cocoapods/repos目录下，再将文件夹重命名为master。

---

Cocoapods的使用

1.使用search命令搜索类库名:好比AFNetworking

$ pod search AFNetworking

获得结果以下图：

从这个图上，咱们看到AFN有好多版本，最新的版本是3.1.0.
注意第三行，这是咱们接下来要添加到Podfile文件里面的内容。
按q退出

2.

(1)打开Xcode，新建一个工程，工程名为swift_test。

(2)使用跳转命令cd到工程目录下：cd后面跟空格，而后跟的是工程目录名。

$ cd /Users/ZGZ/Desktop/swift_test

(3)回车后，输入命令---在工程目录下，建立了一个Podfile文件

$ pod init

3.使用vim编辑Podfile文件

$ vim Podfile

而后在Podfile文件中输入如下文字：

$ pod 'AFNetworking', '~> 3.1.0’

按“ i ”进行编辑，在编辑完后按 esc ，而后按" : "，再输入wq保存退出。

4.利用cocopods下载AFNetworking类库

仍是在终端中的当前项目目录下，运行如下命令：

$ pod install

安装成功后，在工程目录里会看到多了一个.xcworkspace工程，之后打开项目就用 swift_test.xcworkspace 打开，而不是以前的.xcodeproj文件。

5.打开 CocoapodsSample.xcworkspace 工程，能够看到AFNetwoking已经成功导入项目。

另附：

（1）若是有一些包已经存在了，或者咱们更改了Podfile里面的版本，能够在终端cd到该工程目录下使用如下命令更新。

$ pod update

（2）关于Podfile文件编辑时，第三方库版本号的各类写法：pod ‘AFNetworking’ //不显式指定依赖库版本，表示每次都获取最新版本pod ‘AFNetworking’, ‘2.0’ //只使用2.0版本pod ‘AFNetworking’, ‘>2.0′ //使用高于2.0的版本pod ‘AFNetworking’, ‘>=2.0′ //使用大于或等于2.0的版本pod ‘AFNetworking’, ‘<2.0′ //使用小于2.0的版本pod ‘AFNetworking’, ‘<=2.0′ //使用小于或等于2.0的版本pod ‘AFNetworking’, ‘~>0.1.2′ //使用大于等于0.1.2但小于0.2的版本，至关于>=0.1.2而且<0.2.0pod ‘AFNetworking’, ‘~>0.1′ //使用大于等于0.1但小于1.0的版本pod ‘AFNetworking’, ‘~>0′ //高于0的版本，写这个限制和什么都不写是一个效果，都表示使用最新版本