CocoaPods安装及使用教程

1.前言

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

---

2.什么是CocoaPods

CocoaPods是OS X和iOS下的一个第三类库管理工具，通过CocoaPods工具我们可以为项目添加被称为“Pods”的依赖库（这些类库必须是CocoaPods本身所支持的），并且可以轻松管理其版本。

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

接下来我们将介绍CocoaPods的使用。

---

3.CocoaPods的核心组件

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

CocoaPods在解析执行过程中最重要的几个包的路径分别是：

• 1.CocoaPods/CocoaPods
• 2.CocoaPods/Core
• 3.CocoaPods/Xcodeproj。

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

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

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

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

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

---

4.CocoaPods安装步骤

1.检查Ruby环境 
一般来讲Mac OS都是自带Ruby环境的, 所以我们在终端里输入命令: ruby -v 就可以检查Ruby的版本 

---

2.切换Ruby源地址

gem sources --remove https://rubygems.org/ 
//等有反应之后再敲入以下命令 
gem sources -a https://ruby.taobao.org/ 
为了验证你的Ruby镜像是并且仅是taobao，可以用以下命令查看：

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

---

3.安装CocoaPods

在终端里输入命令: sudo gem install cocoapods 等待完成即可.

安装完成之后, 输入下面的命令查看是否安装成功: $ pod 

PS: 如果中途发生错误导致没法完成安装, 再一次执行上面的命令即可

---

4.使用CocoaPods

创建Xcode项目 
(怎么创建Xcode项目这里我就不说了)

使用终端vim编辑器在新建Xcode项目中创建Podfile文件 

编辑Podfile文件

使用命令: cd /Users/用户名/Desktop/项目名// 进入到项目的根目录中然后再使用命令:vim Podfile编辑Podfile文件, 如果项目中没有该文件, vim会自动创建.

这里拿HTHorizontalSelectionList第三方开源项目作为例子: 
platform :ios, ’9.2’ 
pod ‘HTHorizontalSelectionList’, ‘~> 0.6.4’ 
保存退出之后即可.

保存退出之后即可.

PS: 里面的两端文字并不是自己写得, 是需要去GitHub里查看该项目最高支持iOS版本是多少, 以及该开源项目是第几个版本.

安装第三方开源项目

编辑好Podfile文件后, 在终端输入命令: pod install 等待安装完毕, 如果该开源项目有其他项目的依赖, CocoaPods会自动下载对应的依赖项目. 

PS: 如果中途安装失败, 重复命令即可.

---

5.使用项目 

这时我们会看到项目中多了N多文件, 其中Podfile, Podfile.lock, Pods, XcodeDemo.xcworkspace是CocoaPods自己创建的, 直接打开XcodeDemo.xcworkspace文件, 按照GitHub作者给出的使用方法来使用即可.

---

5.最终效果

---

6.升级CocoaPods

1. 先更新gem
2. sudo gem update —system
3. 删除rubygems源
4. gem sources –remove https://rubygems.org/
5. 添加ruby淘宝源
6. gem sources -a https://ruby.taobao.org/
7. 测试源是否正确, 和刚开始安装时一样
8. gem sources -l
9. 安装CocoaPods
10. sudo gem install cocoa pods
11. pod setup
12. 查看CocoaPods版本
13. pod –version

顶