iOS开发之Cocoapods

• 前言

• 什么是Cocoapods？？？
• 答：在iOS开发中势必会用到一些第三方依赖库，比如大家都熟悉的ASIHttpRequest、AFNetworking、JSONKit等。使用这些第三方类库能极大的方便项目的开发，但是，集成这些依赖库需要我们手动去配置，例如集成ASIHttpRequest库时除了加入源码以外还需要手动去添加一些系统框架，比如CFNetwork、MobileCoreServices等，如果这些第三方库发生了更新，还需要手动去更新项目。这就显得非常麻烦。有麻烦自然有解决办法，CocoaPods就是为了解决这个问题而生的。通过CocoaPods，我们可以将第三方的依赖库统一管理起来，配置和更新只需要通过简单的几行命令即可完成，大大的提高了实际开发中的工作效率，使我们的主要精力集中到更重要的事情上去。

• 安装Cocoapods
  

mac系统自带ruby环境，网上有的教程是让你重新装svm,然后利用rvm再装ruby，注意区分。

在此所有的操作都是在终端中操作。(终端设备电脑lunchpad里面)

1.因为Ruby的软件源rubygems.org被屏蔽了，所以要更换源

gem sources --add [https://gems.ruby-china.com/](https://gems.ruby-china.com/) --remove [https://rubygems.org/](https://rubygems.org/)

2.用淘宝的镜像代替(可以去掉)

这一步是因为国内有墙的限制，会造成安装cocoapods的过程变的十分慢，替换为淘宝的镜像速度会相对较快。
 gem sources -a https://ruby.taobao.org/

3.查看是否设置成功

gem sources -l
如果输出结果是如下这样，那说明这一步就成功了。
*** CURRENT SOURCES ***
http://ruby.taobao.org/

4.升级gem

sudo gemupdate--system

5.安装Cocoapods(试试前面的能不能省掉)

sudo gem install cocoapods

6.更换repo镜像为国内服务器

pod repo remove master
pod repo add master https://gitcafe.com/akuandev/Specs.git
pod repo update

7.初始化第三方库

pod setup

7.查看Cocoapods是否支持某个类库，只要能够查询到框架就表明这个这台电脑Cocoapods已经安装成功。

pod search 类库名
支持模糊查询(如:AFNetworking),如果下面显示出AFNetworking框架的各个版本就代表Cocoapods安装完成。

8.以后更新第三方库

pod repo update

可能碰到的问题

1、ERROR: While executing gem ... (Errno::EACCES) Permission denied -    /Users/xxxxx/.gemrc

可以用sudo chown -R xxxx /Users/xxxx/.gemrc解决

2、pod search 搜索库的时候报错Unable to find a specification for xxxxx

解决方法：在终端执行这两句代码，然后重新安装pod,在进行搜索。

pod repo remove master  
 pod setup

3.安装的时候报错说selected xcode error

解决方法:运行这句代码，然后重新安装

sudo xcode-select -switch /Applications/Xcode.app/

Cocoapods相当于一款软件，在电脑上安装成功以后，以后就可以直接使用他来给项目集成框架。不需要重复上面的操作。

• 具体在项目中如何使用Cocoapods

• 我们通过集成MJRefresh类库来演示如何使用CocoaPods来做依赖库管理。首先，建立一个xcode工程，命名为CocoaPodsTest，现在的工程结构如下图所示。

1.关闭新建立的工程，打开终端

• 检查SDWebImage是否支持Cocoapods,支持模糊查询

pod search SDWebImage（在终端输入）

执行后通过输出结果可以看到mjrefresh是支持CocoaPods的，注意红框标记的内容，这是待会我们配置xcode时需要的信息，这条配置项就是告诉CocoaPods去下载和管理第三方库的哪一个版本。** 如果搜索过后最下面出现一个：,则直接点击q便可退出。

• 左下角有一个冒号“ ：”，一般把第一个 pod 'SDWebImage', '~>3.7.6'复制保存，再点击q退出（下面编辑会用）

2.检测完毕后我们在终端里输入下面的代码。

cd +把工程拖进终端（自动生成一个路径）（当然你也可以进行查看输入psw或者ls）

3.管理第三方库的PodFile文件(也就是进行编辑)

vim Podfile（输入代码之后直接进行回车，会跳出来下面的代码框

先把1里面复制的版本代码复制下来放到第三行，再输入下面的代码，按照顺序输入

4.点击Esc退出编辑，再按 shift+; ,最后再按: wq 保存并退出文件。

5.pod install 在工程中安装我想要的框架

pod install

拓展：

--no-repo-update Skip running pod repo update before install: 只更新当前新的第三方，不会更新所有的第三方

Podfile.lock：第一次pod 就会自动生成这个文件，描述当前导入框架版本

pod install：根据Podfile.lock 去加载，第一次会根据podfile文件加载

pod update：去检查之前导入框架有没有新的版本，如果有新的版本就会去加载，并且更新 Podfile.lock

pod repo：管理第三方库的索引，去寻找有没有最新版本，有就记录

6.如果想继续添加框架，只需找到框架的版本号 放到建好的Podfile文件，通过 pod update 进行更新，更新之前要记得让你的终端处于你工程所在的目录下

7.将第三方库集成到项目中

如果之前的全部工作都完成了，工程目录下就会有一个Podfile文件了，注意必须和.xcodeproj在同一个目录下。

会多出一个名为Pods的依赖工程，打开/Pods/Pods文件夹后，能找到我们在Podfile写的各种第三方库。

8.至此用Cocoapods管理第三方框架的所有工作做完。

如果需要依赖多个第三方类库，只需要修改Podfile文件的配置，然后运行pod update命令即可，比如新增一个AFNetworking的依赖库，首先执行pod search AFNetworking查看一下AFNetworking的配置信息，修改Podfile文件，在后面增加AFNetworking的对应配置信息，然后运行pod update命令就完成了对AFNetworking的集成。

• 1、pod search 框架名    找到版本号  pod 'AFNetworking', '~> 3.1.0'
  
• 2、cd 你工程所在的目录，  通过pwd查看当前终端所在的路径
  
• 3、vim Podfile        1.点击i进入编辑状态  2、写内容 3、esc退出编辑，4、：wq保存退出
  

编辑的内容：platform :ios, ‘7.0‘
target "卡顿测试" do
pod 'SDWebImage', '~> 3.7.6'
end

• 4、pod install 在工程中安装我想要的框架
  
• 5、如果想继续添加框架，只需找到框架的版本号 放到建好的Podfile文件，通过pod update进行更新，更新之前要记得让你的终端处于你工程所在的目录下
  

经验之谈

如果在使用cocopods的过程中出现很多的问题,你可以尝试下面的3步骤

1.升级gem

sudo gem update--system

2.安装Cocoapods

sudo gem install cocoapods

3.初始化第三方库

pod setup

声明：使用CocoaPods来添加第三方类库，无论是执行pod install还是pod update都卡在了Analyzing dependencies不动

解决办法： 终端执行下面的代码

pod repo update

为他人的安装cocopods的经验

CocoaPods安装 详细

CocoaPods pod install/pod update更新慢的问题

Cocoapods常用命令及介绍

CocoaPods管理本地库

CocoaPods更新本地仓库的master的下载:下载完直接 command + shift + G 输入 ~/.cocoapods/repos替换掉master就好

升级cocoapods踩坑

9、后续补充

• 9.1、 升级cocoapods到制定版本
  查看cocoapods有多少个版本
  

gem list

• 卸载 cocoapods
  

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

• 安装指定 1.7.2 版本的 Cocoapods
  

sudo gem install cocoapods -v 1.7.2

• 安装指定 最新 版本的 Cocoapods
  

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

• 查看 cocoapods 版本
  

pod --version

10、pod update 报错处理

• 10.1、[!] Failed to connect to GitHub to update the CocoaPods/Specs specs repo - Please check if you are offline, or that GitHub is down.

解决方案：sudo gem install -n /usr/local/bin cocoapods