CocoaPods

一、什么是CocoaPods

CocoaPods是iOS项目的依赖管理工具，该项目源码在Github上管理。开发iOS项目不可避免地要使用第三方开源库，CocoaPods的出现使得我们可以节省设置和第三方开源库的时间。

在使用CocoaPods之前，开发项目需要用到第三方开源库的时候，我们需要

1.把开源库的源代码复制到项目中

2.添加一些依赖框架和动态库

3.设置-ObjC，-fno-objc-arc等参数

4.管理他们的更新

在使用CocoaPods后，我们只需要把用到的开源库放到一个名为Podfile的文件中，然后执行pod install.Cocoapods就会自动将这些第三方开源库的源码下载下来，并且为我们的工程设置好响应的系统依赖和编译参数。

二、CocoaPods的原理

CocoaPods的原理是将所有的依赖库都放到另一个名为Pods的项目中，然后让主项目依赖Pods项目，这样，源码管理工作都从主项目移到了Pods项目中。Pods项目最终会编译成一个名为libPods.a的文件，主项目只需要依赖这个.a文件即可。

三.为什么需要CocoaPods?

在进行iOS开发的时候，总免不了使用第三方的开源库，比如AFNetworking、SDWebImage、SVProgressHUD等等。使用这些库的时候通常需要：

1.下载开源库的源代码并引入工程

2.向工程中添加开源库使用到的framework

3.解决开源库和开源库以及开源库和工程之间的依赖关系、检查重复添    加的framework等问题

4.如果开源库有更新的时候，还需要将工程中使用的开源库删除，重新执行前面的三个步骤，顿时头都大了。。。

自从有了CocoaPods以后，这些繁杂的工作就不再需要我们亲力亲为了，只需要我们做好少量的配置工作，CocoaPods会为我们做好一切！

四.安装CocoaPods

CocoaPods是用Ruby实现的，要想使用它首先需要有Ruby的环境。幸运的是OS X系统默认的已经可以运行Ruby了，因此我们只需要执行以下命令：

更换源：

Gem是一个管理Ruby库和程序的标准包，它通过Ruby Gem(如http://rubygems.org/)源来查找、安装、升级和卸载软件包

1.移除掉原有的源（服务器在国外，速度较慢）

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

2.等有反应之后再敲入以下命令（添加国内的源）(前段时间，taobao.org源统一换成https协议了，请注意)

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

3.验证是否替换成功

gem sources -l

2.更新升级gem:

gem是管理Ruby库和程序的标准包，如果它的版本过低也可能导致安装失败，解决方案自然是升级gem，执行下述命令即可:

更新升级

sudo gemupdate--system

3.安装CocoaPods:

 sudo gem install cocoapods

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

1.移除原有服务器

 pod repo remove master

2.添加境内服务器（建议使用第一个）

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

(开源中国较慢)

pod repo add master http://git.oschina.net/akuandev/Specs.git

四.使用CocoaPods

如果之前做的一切顺利，接下来就可以体验体验CocoaPods的神奇之处了，需要经过以下几步：

1.初始化第三方库信息:

// 初始化

 pod setup

以后更新第三方库信息:

// 更新 

pod repo update

2.搜索:

// 搜索

 pod search mjrefresh

copy 所需库的版本号等信息

3.新建Podfile:

cd /Users/shiyunlei/Desktop/CocoapodsSample

(进入工程目录，cd后面的是工程的路径)

进入到工程的根目录下，使用

pod init

创建空白的Podfile文件，创建完毕的目录结构如下图

使用xcode打开这个文件

platform :ios, '8.0'
use_frameworks!
pod 'MJRefresh', '~> 3.1.0'

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

$pod MJRefresh

因为这个过程需要下载相应的类库，所以时间和网速有关。

这个时候会看到之后打开工程都需要从类型为工程名.xcworkspace文件打开。

5.编辑Podfile:

platform:ios,'8.0'pod'框架名字'pod'框架名字','~> 版本号'

6.解析Podfile:

// 1.安装第三方框架pod install --verbose --no-repo-update// 2.升级第三方框架pod update

完成后，我们需要使用CocoaPodsTest.xcworkspace文件来开发。

对于工程发生的变化，有几点需要说明：

第三方库会被编译成静态库供我们正真的工程使用

CocoaPods会将所有的第三方库以target的方式组成一个名为Pods的工程，该工程就放在刚才新生成的Pods目录下。整个第三方库工程会生成一个名称为libPods.a的静态库提供给我们自己的CocoaPodsTest工程使用。

我们的工程和第三方库所在的工程会由一个新生成的workspace管理

为了方便我们直观的管理工程和第三方库，CocoaPodsTest工程和Pods工程会被以workspace的形式组织和管理，也就是我们刚才看到的CocoaPodsTest.xcworkspace文件。

原来的工程设置已经被更改了，这时候我们直接打开原来的工程文件去编译就会报错，只能使用新生成的workspace来进行项目管理。

5.常见问题解决

以后使用CocoaPods过程中出现了莫名其妙的问题，执行下面命令

-sudo gem update --system-sudo gem install cocoapods-pod setup

升级10.11后，运行pod命令出现：

-bash: pod: command not found

解决办法：

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

之后pod命令可以使用了。

---

如果pod update / pod install 卡在：

Updating local specs repositories

等待即可，或者

可以使用 “pod install --verbose --no-repo-update” 进行下载，原因可能x被墙。

pod install --verbose --no-repo-update

即可。

转载于:https://my.oschina.net/markweb/blog/626391