当你开发iOS应用时,会常用到不少第三方开源类库,好比JSONKit,AFNetWorking等等。手动一个个去下载所需类库十分麻烦。另一种常见状况是,你项目中用到的类库有更新,你必须得从新下载新版本,从新加入到项目中,十分麻烦。因此,你须要CocoaPods。CocoaPods应该是iOS最经常使用最有名的类库管理工具了,上述两个烦人的问题,经过cocoaPods,只须要一行命令就能够彻底解决,固然前提是你必须正确设置它。重要的是,绝大部分有名的开源类库,都支持CocoaPods.ios
在本地安装好Ruby环境json
OS X系统默承认以运行Ruby,运行sudo gem update --system 升级Ruby,vim
移除现有Ruby默认源api
$ gem sources --remove https://rubygems.org/xcode
//等有反应以后再敲入如下命令ruby
$ gem sources -a https://ruby.taobao.org/网络
验证新源是否替换成功工具
$gem sources -l测试
若是显示以下就是成功的,上面的命令,有时试了会没有效,请参考淘宝网的https://ruby.taobao.orgfetch
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
若是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