CocoaPods安装与使用

一、安装CocoaPods

Mac系统已经默认安装好Ruby环境，如果你不确定自己系统中是否有Ruby的，可以在终端中输入命令行：ruby -v查看当前ruby版本。如图：

确定以后，接下来就可以下载和安装CocoaPods，只需要一行命令。在Terminator（也就是终端）中输入以下命令：

　　　sudo gem install cocoapods

但是，在终端中敲入这个命令之后，会发现半天没有任何反应。原因是那堵墙阻挡了cocoapods.org。

解决办法是，我们可以用淘宝或者阿里云的Ruby镜像来访问cocoapods。按照下面的顺序在终端中敲入依次敲入命令：

首先，检查ruby源：

$gem sources -l

默认情况下，终端应该返回如下信息：

*** CURRENT SOURCES ***

https://rubygems.org/

当然这个源在墙内是访问不到的。因此我们需要寻找一个可以在国内访问到的镜像。目前笔者找到的是http://rubygems-china.oss.aliyuncs.com这个阿里云的镜像，当然随着时间的推移，未来这个镜像也有可能无法访问了，到时候就只能重新寻找了。

确认镜像可用后，现在就要开始修改ruby源了。首先执行以下命令删除原来的ruby源：

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

执行命令后可在终端看见以下信息：

https://rubygems.org/ removed from sources

然后下一步添加你找到的可用的镜像源：

$gem sources -a https://ruby.taobao.org/ #(淘宝)

或者：

$gem sources -a http://rubygems-china.oss.aliyuncs.com #(阿里云)

gem sources -l #(再次查看当前ruby的源)

如果Terminal输出：

*** CURRENT SOURCES ***

https://ruby.taobao.org/

此时你就可以重新执行这一段开头的那句命令了：

$sudo gem install cocoapods

• 如果gem太老，可以尝试用如下命令升级gem：

在Terminal输入以下命令：

$sudo gem update --system

升级成功后会提示: Latest version currently installed. Aborting.

• 如果报以下错误：

ERROR: While executing gem ... (Errno::EPERM)

Operation not permitted - /usr/bin/xcodeproj

解决方案1：

执行下面的命令并重启

$sudo nvram boot-args="rootless=0"

$sudo reboot

重启之后, 执行这个命令检查

$sudo gem install cocoapods -V

如果依旧有错误，使用第二个方案

解决方案2：

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

如果一切正常，你应该能看到一段安装进度，以及最后有一条信息：

xx gems installed

开始配置

$pod setup

还有一点需要注意，pod setup在执行时，会输出Setting up CocoaPods master repo，但是会等待比较久的时间。这步其实是 Cocoapods 在将它的信息下载到 ~/.cocoapods目录下，如果你等太久，可以试着 cd 到那个目录，用du -sh *来查看下载进度。

安装成功后,你会看到:Setup completed

二、使用CocoaPods

打开终端，使用cd命令定位到需要使用CocoaPods的项目根路径。如：

cd /Users/username/ Projects/Demo

先考虑项目中需要引用哪些库，然后在通过search命令来查找库的信息，如需要加入JSONKit，那可以如下写法：

pod search JSONKit

命令执行后会得到如下结果：

-> JSONKit (1.5pre)

 A Very High Performance Objective-C JSON Library.

 pod 'JSONKit', '~> 1.5pre'

 - Homepage: https://github.com/johnezang/JSONKit

 - Source: https://github.com/johnezang/JSONKit.git

 - Versions: 1.5pre, 1.4 [master repo]

其中的pod 'JSONKit', '~> 1.5pre'是待会要写入到Podfile中的信息。如果已经知道这些信息，那可以直接省略此步。直接进行下面的步骤。

得到必要的库信息后，现在需要在项目中建立Podfile文件。通过下面的命令：

touch Podfile

然后编辑Podfile文件，命令如下：

open -e Podfile

在弹出的编辑界面中输入下面内容：

platform :ios

pod 'JSONKit', '~> 1.5pre'

然后调用下面命令来进行初始化：

pod install

运行完毕后，原本的项目目录会多出一些文件。如图：

image.png

文件目录中多了*.xcworkspace , pod等文件。这是pod生成的项目管理文件，打开LibDemo.xcworkspace项目文件，在Xcode里看到是这样的目录结构：

image.png

这里要注意的一点是，如果不调用创建Podfile命令就直接调用pod install命令。将会提示“[!] No 'Podfile' found in the current working directory.”

如果Podfile中添加了新库，可以使用下面命令进行更新：

pod update

现在，你的所有第三方库都已经下载完成并且设置好了编译参数和依赖，你只需要记住如下2点即可：

• 使用CocoaPods生成的 .xcworkspace文件来打开工程，而不是以前的.xcodeproj文件。

• 每次更改了Podfile文件，你需要重新执行一次pod install或者pod update命令 。