CocoaPods使用详细说明

一、概要

iOS开发时，项目中会引用许多第三方库，CocoaPods（https://github.com/CocoaPods/CocoaPods）可以用来方便的统一管理这些第三方库。

二、安装

安装方式异常简单
, Mac 下都自带 ruby，使用 ruby 的 gem 命令即可下载安装：

sudo gem install cocoapods

由于某些原因，执行时会出现下面的错误提示

ERROR:  Could not find a valid gem 'cocoapods' (>= 0), here is why:
Unable to download data from https://rubygems.org/ - Errno::EPIPE: Broken pipe - SSL_connect (https://rubygems.org/latest_specs.4.8.gz)

因为ruby
的软件源 https://rubygems.org 因为使用的是亚马逊的云服务，所以被墙了，需要更新一下
ruby 的源，使用如下代码将官方的 ruby 源替换成国内淘宝的源，当出现上述的问题的时候

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

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

*** CURRENT SOURCES ***
 http://ruby.taobao.org/[/code] 
这时候，你再次在终端中运行：
sudo gem install cocoapods
pod setup


如果Ruby环境不够新，可能需要更新以下：
sudo gem update --system
等上十几秒钟，CocoaPods就可以在你本地下载并且安装好了，不再需要其他设置。

在这里搜索你想要的第三方库

<span style="font-size:14px;">pod search Reachability</span>


三.使用

使用CocoaPods的第一步，是在当前项目下，新建一个Podfile文件：Podfile文件要放在XXX.xcodeproj同一目录下
touch Podfile
<pre name="code" class="ruby">open Podfile






使用cocoadPod
updating local specs repositories 卡住
pod install  换成pod install --verbose --no-repo-update这个命令，前面的命令被墙了




然后利用vim打开Podfile文件编辑，加入你想要使用的类库，格式如下：（键盘输入 i，进入编辑模式，输入；然后按Esc，并且输入“
：”号进入vim命令模式，然后在冒号后边输入wq）open Podfile

platform :ios
pod 'Reachability', '3.1.0'

platform:ios, '6.0'
pod 'JSONKit','1.4'
pod 'AFNetworking', '~> 2.3.1'


在终端通过cd 命令切换路径到Podfile文件所在目录，然后再输入命令 pod install 或者 pod update

如果是拷贝的别人的项目，或是一个很久没打开过的项目，可能需要先执行一下：
pod update
确定终端cd到项目总目录，然后输入 
pod install

这个时候会看到项目文件夹下多了一个文件xxx.xcworkspace，以后要通过这个文件打开项目，老项目文件xxx.xcodeproj不再使用。

P.s.1
如果上面因为权限问题安装失败，必须每次都要删除，因为这个缓存中会存下你的github的东西，造成每次都调用上次权限问题的缓存。
<span style="font-size:14px;">rm -rf /Users/loginnanme/Library/Caches/CocoaPods/</span>
P.s.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.0
pod ‘AFNetworking’, ‘~>0.1′     //使用大于等于0.1但小于1.0的版本
pod ‘AFNetworking’, ‘~>0′     //高于0的版本，写这个限制和什么都不写是一个效果，都表示使用最新版本


四.更新CocoaPods

$ pod install
[!] The 'master' repo requires CocoaPods 0.32.1 -
失败  提示需要0.32.1版本

查看现在的版本号

$ pod --version
0.29.0


执行更新安装步骤

$ sudo gem update --system // 先更新gem，国内需要切换源
$ gem sources --remove https://rubygems.org/ $ gem sources -a http://ruby.taobao.org/ $ gem sources -l
\*\*\* CURRENT SOURCES \*\*\* http://ruby.taobao.org/ $ sudo gem install cocoapods // 安装cocoapods
$ pod setup


检查现在版本号

$ pod --version
0.32.1