如何使用CocoaPods安装使用及配置私有库以及管理依赖库 【原创】

CocoaPods是什么

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

 

安装cocoapods

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

1, 将ruby的原生镜像移除

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

   用淘宝的镜像代替

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

 

PS：这一步是因为国内有墙的限制，会造成安装cocoapods的过程变的十分慢，替换为淘宝的镜像就相当于FQ。

 

2, 查看是否设置成功

$ gem sources -l

如果输出结果是如下这样，那说明这一步就成功了。

*** CURRENT SOURCES ***

http://ruby.taobao.org/

 

3, 然后安装cocoapods:

$ sudo gem install cocoapods

 

4, 查看cocoapods是否支持某个类库

$ pod search 类库名, 支持模糊查询(如:AFNetworking)

 

如何在项目中使用cocoapods？

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

 这里我们要集成JSONKit，可以先通过如下命令来判断其是否支持CocoaPods。

“`
$ pod search mjrefresh
“`

PS:支持模糊查询

执行后通过输出结果可以看到mjrefresh是支持CocoaPods的，注意红框标记的内容，这是待会我们配置xcode时需要的信息，这条配置项就是告诉CocoaPods去下载和管理那一个版本的第三方库。

出现Setting up CocoaPods master repo，说明Cocoapods在将它的信息下载到 ~/.cocoapods里，cd  到该目录里，用du -sh *命令来查看文件大小，每隔几分钟查看一次，我的这个目录最终大小是211M，就是完成了，。如果不成功，在下面会显示一个git的网址，在这个网址下载相应的文件放在电脑相应的文件夹即可。

 

 

 

检测完毕后我们来到工程CocoaPodsTest的目录下，新建一个名为Podfile的文件（这里通过命令行创建）

$ vim Podfile

这个Podfile文件的作用是配置依赖库信息，就是告诉CocoaPods去下载和管理哪些依赖库，文件创建好以后，打开文件并加入如下内容。（vim打开文件后按i进入插入模式，编辑完成后按esc退出编辑模式，接着输入:wq保存并退出文件）

 

这时候，工程目录下就会有一个Podfile文件了，注意必须和.xcodeproj在同一个目录下。接下来就可以使用CocoaPods来安装并管理JSONKit库了，确保命令行当前路径是在CocoaPodsTest目录下，运行如下命令。

$ pod install

安装完成后会提示如下信息，并且我们的工程目录下会多出一个.xcworkspace结尾的文件，命令行信息绿色部分提醒我们“从此使用CocoaPodsTest.xcworkspace来打开项目”。

通过CocoaPodsTest.xcworkspace来打开项目，这时，我们的项目工程结构就会变成下图这样，多出一个名为Pods的依赖工程，打开Pods文件夹后，发现MJRefresh已经在里面了

 

在Mac安装Cocoapods时出现

[!] CocoaPods was not able to update the `master` repo. If this is an unexpected issue and persists you can inspect it running `pod repo update --verbose`

找了很多资料，找到一种解决方法，纪录在此

rm -fr ~/.cocoapods/repos/master pod setup

 

 

这时候就可以在项目文件中引入JSONKit.h了，这时候如果你发现import的时候没有提示JSONKit的文件，可以在target-Build Settings下修改“User Header Search Paths”项，新增${SRCROOT}并选择rcursive，如下图。

 

设置完成后就可以在文件中直接引用第三方库的文件并使用了。

 

到此，新建工程并使用CocoaPods来管理依赖库的过程就完成了，如果是直接使用已有CocoaPods的项目，则需要首先运行一下pod update命令来更新项，然后照样通过.xcworkspace来打开工程。

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

 

添加AFNetworking库后的目录结构如下。

 

如果类库有更新，查看更新配置并执行pod update即可简单完成了，从此从手动更新繁重的体力劳动中解脱出来。

简单小结一下：

- 安装CocoaPods
- 新建项目并在工程根目录下新建Podfile文件，配置需要管理的第三方库
- 运行pod install下载安装第三方库