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
来源:oschina
链接:https://my.oschina.net/u/2374931/blog/674158