CocoaPods安装及使用

前言

在iOS项目中使用第三方类库可以说是非常常见的事，但是要正确地配置他们有时候是非常繁琐的事情，幸运的是CocoaPods是一个很好的解决方案。

一、什么是CocoaPods

CocoaPods是一个负责管理iOS项目中第三方开源库的工具。CocoaPods的项目源码在Github上管理。该项目开始于2011年8月12日，在这两年多的时间里，它持续保持活跃更新。开发iOS项目不可避免地要使用第三方开源库，CocoaPods的出现使得我们可以节省设置和更新第三方开源库的时间

Cocoapods意义体现在两个方面。

• 第一，在引入第三方库时它可以自动为我们完成各种各样的配置，包括配置编译阶段、连接器选项、甚至是ARC环境下的-fno-objc-arc配置等。
• 第二，使用CocoaPods可以很方便地查找新的第三方库，这些类库是比较“标准的”，而不是网上随便找到的，这样可以让我们找到真正好用的类库。

二、CocoaPods的核心组件

CocoaPods是用Ruby写的，并划分成了若干个Gem包。

CocoaPods在解析执行过程中最重要的几个包的路径分别是：CocoaPods/CocoaPods、 CocoaPods/Core和 CocoaPods/Xcodeproj。

1、CocoaPods/CocoaPods

CocoaPods / CocoaPod：这是面向用户的组件，每当执行一个pod命令时，这个组件将被激活。它包括了所有实用CocoaPods的功能，并且还能调用其他gem包来执行任务。

2、CocoaPods/Core

CocoaPods / Core：Core gem提供了与CocoaPods相关的文件（主要是podfile和podspecs）的处理。

• （1）、Podfile：该文件用于配置项目所需要的第三方库，它可以被高度定制。本文中我们主要在这里做动作。

• （2）、Podspec：该文件描述了一个库将怎样被添加进工程中。.podspec文件可以标识该第三方库所需要的源码文件、依赖库、编译选项，以及其他第三方库需要的配置。

3、CocoaPods / Xcodeproj

CocoaPods / Xcodeproj：这个包负责处理工程文件，它能创建以及修改.xcodeproj文件和.xcworkspace文件。它也可以作为一个独立的包使用，当你要编写修改项目文件的脚本时，可以考虑使用CocoaPods/Xcodeproj。

三、Cocoapods安装步骤

1、升级Ruby环境

终端输入：

$gem update --system

此时会出现

Updating rubygems-update
Fetching: rubygems-update-2.6.6.gem (100%)
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

来进行升级。

2、ruby镜像

安装CocoaPods时我们要访问cocoapods.org，该网站可能被我们大天朝墙了，这样下载安装可能会是龟速，幸好我们可以用淘宝的Ruby镜像来访问该网站，方法如下：
（1）、移除现有 Ruby 默认源

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

（2）、使用新的源

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

（3）、验证新源是否替换成功

$ gem sources -l

3、安装Cocoapods

在终端输入命令

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

备注：苹果系统升级 OS X EL Capitan 后安装改为:

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

$ pod setup

注意：
执行pod setup 命令

出现Setting up CocoaPods master repo，说明Cocoapods在将它的信息下载到 ~/.cocoapods里；

cd 到该目录里，用du -sh *命令来查看文件大小，每隔几分钟查看一次，这个目录最终大小是733M，就是完成了，下载时间较长，请耐心等待。

ps：
错误提示

    Error installing cocoapods:  activesupport requires Ruby version >= 2.2.2.

解决方案 ：
（1）、安装 RVM baby 版本管理器

$curl -L get.rvm.io | bash -s stable

//________等安装完成 出现下面这行提示以下___________

In case of problems: https://rvm.io/helpandhttps://twitter.com/rvm_io

执行

$source ~/.bashrc  

$source ~/.bash_profile  

测试是否安装正常

$rvm -v  

//________提示以下___________

rvm 1.27.0 (latest) by Wayne E. Seguin, Michal Papis[https://rvm.io/]

（2）、用RVM升级Ruby查看当前ruby版本

$ruby -v 

$rvm list known

//________提示以下___________

# MRI Rubies

[ruby-]1.8.6[-p420]

[ruby-]1.8.7[-head] # security released on head

[ruby-]1.9.1[-p431]

[ruby-]1.9.2[-p330]

[ruby-]1.9.3[-p551]

[ruby-]2.0.0[-p648]

[ruby-]2.1[.8]

[ruby-]2.2[.4]

[ruby-]2.3[.0]

[ruby-]2.2-headruby-head

# for forks use: rvm install ruby-head---url https://github.com/github/ruby.git --branch 2.2

# JRuby

安装ruby 2.2.2 执行

$rvm install 2.2.2

打印

ruby-2.2.2 - #validate archive
    ruby-2.2.2 - #extract
    ruby-2.2.2 - #validate binary
    ruby-2.2.2 - #setup
    ruby-2.2.2 - #gemset created /Users/abc/.rvm/gems/ruby-2.2.2@global
    ruby-2.2.2 - #importing gemset             
   /Users/abc/.rvm/gemsets/global.gems..............................
    ruby-2.2.2 - #generating global wrappers........
    ruby-2.2.2 - #gemset created /Users/abc/.rvm/gems/ruby-2.2.2
    ruby-2.2.2 - #importing gemsetfile /Users/abc/.rvm/gemsets/default.gems                          
 　　evaluated to empty gem list 
    ruby-2.2.2 - #generating default wrappers........
    Updating certificates in '/etc/openssl/cert.pem'.
    mkdir: /etc/openssl: Permission denied
    mkdir -p "/etc/openssl" failed, retrying with sudo
    LiuWenqiang password required for 'mkdir -p /etc/openssl': 
    and sudo mkdir worked

则说明安装成功了

查看版本

$ pod --version

打印：

1.0.1

4、 更新 gem

$sudo gem update --system

5、更新master

$ pod repo update master

6、新建 Podfile 文件

在终端用 cd 指令到文件夹内，新建 Podfile 文件

$ touch Podfile

执行

$ pod install

7、添加三方库

（1）、查找

$ pod search 第三方

例如：

$ pod search AFNetworking

退出：
esc+Q

（2）、编辑Podfile文件

$ vim Podfile

进入如下页面：

然后紧接着按键盘上的“i”键，变成如下状态，这个时候可以对Podfile文件进行编辑：

$ platform:ios, '7.0'
$ target 'firstPodDemo' do
$   pod 'AFNetworking', '~> 3.1.0'
$ end

在编辑完成后按”esc”，在按”shift”+”:”,这个时候输入wq，点击回车，保存并退出。

7、导入三方库

在终端输入命令安装相应的第三方类库

$ pod install

然后安装成功

之后关闭工程，从类型为工程名.xcworkspace文件打开即可。

四、可能遇到的错误提示及解决方法

Error 1：

Error fetching http://ruby.taobao.org/:

bad response Not Found 404 (http://ruby.taobao.org/specs.4.8.gz)

解决方案：

把安装流程中

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

改为：

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

Error 2：

[!] Unable to satisfy the following requirements:

- `AFNetworking (~> 2.3.1)` required by `Podfile`

Specs satisfying the `AFNetworking (~> 2.3.1)` dependency were found, but they required a higher minimum deployment target.

解决方案：
Podfile 文件 中 platform:ios, ‘8.0’ 后边的 8.0 是平台版本号 ，一定要加上。

Error 3：

The dependency `AFNetworking (~> 2.3.0)` is not used in any concrete target.

解决方案：
新的版本cocoapods
把如下代码：

$ platform:ios, '7.0'
$ pod 'AFNetworking', '~> 3.1.0'

改成：

$ platform:ios, '7.0'
$ target 'firstPodDemo' do
$   pod 'AFNetworking', '~> 3.1.0'
$ end

Error 4：

Error installing cocoapods:  activesupport requires Ruby version >= 2.2.2.

解决方案 ：
（1）、安装 RVM baby 版本管理器

$curl -L get.rvm.io | bash -s stable

//________等安装完成 出现下面这行提示以下___________

In case of problems: https://rvm.io/helpandhttps://twitter.com/rvm_io

执行

$source ~/.bashrc  

$source ~/.bash_profile  

测试是否安装正常

$rvm -v  

//________提示以下___________

rvm 1.27.0 (latest) by Wayne E. Seguin, Michal Papis[https://rvm.io/]

（2）、用RVM升级Ruby查看当前ruby版本

$ruby -v 

$rvm list known

//________提示以下___________

# MRI Rubies

[ruby-]1.8.6[-p420]

[ruby-]1.8.7[-head] # security released on head

[ruby-]1.9.1[-p431]

[ruby-]1.9.2[-p330]

[ruby-]1.9.3[-p551]

[ruby-]2.0.0[-p648]

[ruby-]2.1[.8]

[ruby-]2.2[.4]

[ruby-]2.3[.0]

[ruby-]2.2-headruby-head

# for forks use: rvm install ruby-head---url https://github.com/github/ruby.git --branch 2.2

# JRuby

安装ruby 2.2.2 执行

$rvm install 2.2.2

打印

ruby-2.2.2 - #validate archive
    ruby-2.2.2 - #extract
    ruby-2.2.2 - #validate binary
    ruby-2.2.2 - #setup
    ruby-2.2.2 - #gemset created /Users/abc/.rvm/gems/ruby-2.2.2@global
    ruby-2.2.2 - #importing gemset             
   /Users/abc/.rvm/gemsets/global.gems..............................
    ruby-2.2.2 - #generating global wrappers........
    ruby-2.2.2 - #gemset created /Users/abc/.rvm/gems/ruby-2.2.2
    ruby-2.2.2 - #importing gemsetfile /Users/abc/.rvm/gemsets/default.gems                          
 　　evaluated to empty gem list 
    ruby-2.2.2 - #generating default wrappers........
    Updating certificates in '/etc/openssl/cert.pem'.
    mkdir: /etc/openssl: Permission denied
    mkdir -p "/etc/openssl" failed, retrying with sudo
    LiuWenqiang password required for 'mkdir -p /etc/openssl': 
    and sudo mkdir worked

则说明安装成功了
然后继续安装 CocoaPods

$sudo gem install cocoa pods

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

$pod setup

Error 5:

无法搜到到最新SDK
解决办法：
执行

$ pod repo update

更新本地仓库

五、关于 Podfile.lock

当你执行pod install之后，除了 Podfile 外，CocoaPods 还会生成一个名为Podfile.lock的文件，Podfile.lock 应该加入到版本控制里面，不应该把这个文件加入到.gitignore中。因为Podfile.lock会锁定当前各依赖库的版本，之后如果多次执行pod install 不会更改版本，要pod update才会改Podfile.lock了。这样多人协作的时候，可以防止第三方库升级时造成大家各自的第三方库版本不一致。
CocoaPods 的这篇 官方文档 也在What is a Podfile.lock一节中介绍了Podfile.lock的作用，并且指出：

This file should always be kept under version control.