iOS-cocoaPods安装，使用，卸载

CocoaPods是什么?

当你开发iOS应用时,会经常使用到很多第三方开源类库,比如JSONKit,AFNetWorking等等。手动一个个去下载所需类库十分麻烦。另外一种常见情况是,你项目中用到的类库有更新,你必须得重新下载新版本,重新加入到项目中,十分麻烦。所以,你需要CocoaPods。CocoaPods应该是iOS最常用最有名的类库管理工具了,上述两个烦人的问题,通过cocoaPods,只需要一行命令就可以完全解决,当然前提是你必须正确设置它。重要的是,绝大部分有名的开源类库,都支持CocoaPods.

如何下载和安装CocoaPods?

在本地安装好Ruby环境

OS X系统默认可以运行Ruby,运行sudo gem update --system 升级Ruby，

移除现有Ruby默认源

$ gem sources --remove https://rubygems.org/
//等有反应之后再敲入以下命令

$ gem sources -a https://ruby.taobao.org/
验证新源是否替换成功

$gem sources -l

如果显示如下就是成功的，上面的命令，有时试了会没有效，请参考淘宝网的https://ruby.taobao.org



cocoapods

这时候,你再次在终端中运行:

$ sudo gem install cocoapods

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

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

等上一会,CocoaPods就可以在你本地下载并且安装好了,不再需要其他设置。

然后$ pod setup

等上一大会，Setting up CocoaPods master repo 结束，就可以使用了。。。

使用CocoaPods

使用CocoPods和安装它一样简单,也是通过一两行命令就可以搞定。

小编在这里用两种使用场景来具体说明如何使用CocoaPods。

们可以尝试搜索一个第三方类库：

pod search AFNetworking

过几秒钟之后,你会在终端中看到关于AFNetworking类库的一些信息。这说明,AFNetworking是支持CocoaPods,所以我们可以利用CocoaPods将AFNetworking导入你的项目中。

如果失败 确定是不是安装好 ，如果安装没问题

rm ~/Library/Caches/CocoaPods/search_index.json

pod search AFNetworking

CocoaPods使用

如果OK 了，在终端中进入

(cd命令)你项目所在目录,然后在当前目录下,利用vim创建Podfile,运行:

$ vim Podfile

然后在Podfile文件中输入以下文字:

platform :ios, '7.0'

pod "AFNetworking", "~> 2.0"

当前AFNetworking支持的iOS最高版本是iOS 7.0,要下载的AFNetworking版本是2.0。

关于Podfile文件编辑时，第三方库版本号的各种写法：

pod ‘AFNetworking’      //不显式指定依赖库版本，表示每次都获取最新版本
pod ‘AFNetworking’,  ‘2.0’     //只使用2.0版本
pod ‘AFNetworking’, ‘>2.0′     //使用高于2.0的版本
pod ‘AFNetworking’, ‘>=2.0′     //使用大于或等于2.0的版本
pod ‘AFNetworking’, ‘<2.0′     //使用小于2.0的版本
pod ‘AFNetworking’, ‘<=2.0′     //使用小于或等于2.0的版本
pod ‘AFNetworking’, ‘~>0.1.2′     //使用大于等于0.1.2但小于0.2的版本，相当于>=0.1.2并且<0.2.0
pod ‘AFNetworking’, ‘~>0.1′     //使用大于等于0.1但小于1.0的版本
pod ‘AFNetworking’, ‘~>0′     //高于0的版本，写这个限制和什么都不写是一个效果，都表示使用最新版本

然后保存退出。vim环境下,保存退出命令是:

:wq

小提示：（终端vim/vi文件 按 i 可编辑 ，esc 退出编辑，：wq 或者ZZ 可保存退出）

这时候,你会发现你的项目目录中,出现一个名字为Podfile的文件,

而且文件内容就是你刚刚输入的内容。注意,Podfile文件应该和你

的工程文件.xcodeproj在同一个目录下。

这时候,你就可以利用CocoPods下载AFNetworking类库了。还是

在终端中的当前项目目录下,运行以下命令:

$ pod install

(如果在pod install、或者pod update时，不想升级specs库，可以增加忽略参数

pod install --no-repo-update

pod update --no-repo-update)

因为是在你的项目中导入AFNetworking,这就是为什么这个命令需

要你进入你的项目所在目录中运行。

运行上述命令之后,小编的终端出现以下信息:

[i] From now on use ‘cocoaPodsDemo.xcworkspace’

注意最后一句话,意思是:以后打开项目就用CocoaPodsDemo.xcworkspace打开,而不是之前的.xcodeproj文件。

如果出现


就是说你在Podfile文件里面的语句格式错了

你也许会郁闷,为什么会出现.xcodeproj文件呢。这正是你刚刚运

行$ pod install命令产生的新文件。除了这个文件,你会发现还多了另外一个文件“Podfile.lock”和一个文件夹“Pods”。 点击CocoaPodsDemo.xcworkspace打开之后工程之后你会惊喜地发现,AFNetwoking已经成功导入项目了(红框部分)!现在,你就可以开始使用AFNetworking.h啦。可以稍微测试一下,

在你的项目任意代码文件中输入:

#import

或者

#import "AFNetworking.h"

然后编译,看看是否出错。

总结一下就是:

•先在项目中创建Podfile,Podfile的内容是你想导入的类库。一般类库的原作者会告诉你导入该类库应该如何写Podfile;

•运行命令:`$ pod install.

场景2:如何正确编译运行一个包含CocoPods类

库的项目你也许曾经遇到过(特别是新手iOS开发者)这种情况,好不容易在

GitHub上找到一份代码符合自己想需求,兴冲冲下载下来,一编译,

傻眼了,发现有各种各样错误。一看,原来是缺失了各种其他第三

方类库。这时候莫慌,你再仔细一看,会发现你下载的代码包含了Podfile。没错,这意味着你可以用CocoaPods很方便下载所需要的类库。

下面,小编以代码UAAppReviewManager为例来说明如何正确编

译运行一个包含CocoPods类库的项目。

UAAppReviewManager是一个能够让你方便地将提醒用户评分的

功能加入你的应用中。当你去UAAppReviewManager的GitHub地

址下载这份代码之后,打开Example工程

(UAAppReviewManagerExample),编译,你会发现Xcode报告

一大堆错误,基本都是说你编译的这份代码找不到某某头文件,这就意味着你要成功编译UAAppReviewManager的Example代码,

必须先导入一些第三方类库。同时你会发现在UAAppReviewManagerExample文件夹下面有三个跟CocosPods相关的文件(文件夹):Podfile,Podfile.lock和Pods,如下图:



用这时候,打开终端,进入UAAppReviewManagerExample所在的目录,也就是和Podfile在同一目录下,和场景1一样,输入以下命令

(由于已经有Podfile,所以不需要再创建Podfile):

$ pod update过几秒(也许需要十几秒,取决于你的网络状况)之后,终端出现:

Analyzing dependencies

Fetching podspec for `UAAppReviewManager` from `../`Downloading dependencies

Installing UAAppReviewManager (0.1.6)

Generating Pods project

Integrating client project

[!] From now on use `UAAppReviewManagerExample.xcworkspace`.这时候,再回到UAAppReviewManagerExample文件夹看一看,

会看到多了一个文件UAAppReviewManagerExample.xcworkspace:



直接运行项目

运行成功

注意,这里有个小问题,如果刚刚你不是输入$ pod update,而是输入$ pod install,会发现类库导入不成功,并且终端出现下面

提示:

[!] Required version (UAAppReviewManager (from `../`)) notfound for `UAAppReviewManager`.

Available versions: 0.1.6这里的意思大概是Podfile文件过期,类库有升级,但是Podfile没有

更改。$ pod install只会按照Podfile的要求来请求类库,如果类

库版本号有变化,那么将获取失败。但是$ pod update会更新所有

的类库,获取最新版本的类库。而且你会发现,如果用了$ pod

update,再用$ pod install就成功了。

那你也许会问,什么时候用$ pod install,什么时候用$ pod

update呢,我又不知道类库有没有新版本。好吧,那你每次直接用$ pod update算了。或者先用$ pod install,如果不行,再用$

pod update。

终端 cocoapods 下载bug调试：

错误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/
错误2：

ERROR: While executing gem ... (Errno::EPERM)

Operation not permitted - /usr/bin/pod

解决方案：苹果系统升级OS X EL Capitan后会出现的插件错误，将安装流程 4.安装CocoaPods 的 (1)sudo gem install cocoapods ——>改为sudo gem install -n /usr/local/bin cocoapods

错误3：

[!] Unable to satisfy the following requirements: - `AVOSCloud (~> 3.1.6.3)` required by `Podfile`

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

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

其他解决不了的

解决方案：

$ sudo rm -rf ~/.cocoapods/repos/master

$ pod setup