新版 cocoapod安装、更新和使用 , 安装中出现的错误及解决方案

2017-06-17 10:37:29来源:oschina作者:疯狐狸12138人点击

1.mac系统已经默认安装好Ruby环境,如果你不确定自己系统中是否有Ruby的,可以在终端中输入命令行:ruby -v查看当前ruby版本



如果ruby版本较低,可以通过rvm对Ruby进行升级


1)安装 ram


RVM:Ruby Version Manager,Ruby版本管理器,包括Ruby的版本管理和Gem库管理(gemset)


$curl -Lget.rvm.io | bash -s stable


2)加载文件,测试是否安装正常(按照提示操作)


$ source ~/.bashrc


$ source ~/.bash_profile


$ source ~/.profile


$ rvm -v


3)reload rvm


$ rvm reload rvm


$rvm -v


4)查看当前ruby版本 ,获取rvm 列表


$ruby -v


$rvm list known


5)重新安装ruby


安装完成后, 需要重新执行安装cocoapods的命令


$ rvm install 2.3


6)安装rails


$ gem install rails


如果想要卸载ruby,需要执行以下步骤


$ rvm list


$rvm remove2.3


如果想要卸载rvm 所有版本 ,解决所有问题,重新安装


$rvm implode


这样有关ruby更新的问题已经处理完毕了


2.CocoaPods的安装

在安装CocoaPods之前,首先要在本地安装好Ruby环境。至于如何在Mac中安装好Ruby环境,请google一下,本文不再涉及。


假如你在本地已经安装好Ruby环境,那么下载和安装CocoaPods将十分简单,只需要一行命令。在Terminator(也就是终端)中输入以下命令(注意,本文所有命令都是在终端中输入并运行的。什么,你不知道什么是终端?那请小编吃饭,小编告诉你):


sudo gem install cocoapods

但是,且慢。如果你在天朝,在终端中敲入这个命令之后,会发现半天没有任何反应。原因无他,因为那堵墙阻挡了cocoapods.org。(你会问,我靠,这都要墙!是的,小编也纳闷。)


但是,是的,又但是(不过是个可喜的“但是”)。我们可以用淘宝的Ruby镜像来访问cocoapods。按照下面的顺序在终端中敲入依次敲入命令:


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

为了验证你的Ruby镜像是并且仅是taobao,可以用以下命令查看:


$ gem sources -l

只有在终端中出现下面文字才表明你上面的命令是成功的:


*** CURRENT SOURCES ***
http://ruby.taobao.org/

上面所有的命令完成之时,在小编的终端上是这个的样子:


Figure 1


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


$ sudo gem install cocoapods

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


敲入以上命令时,小编终端上是这个样子的(由于太长,仅截取前面一部分):

3.CocoaPods的使用


1)CocoaPods的搜索功能


pod search AFNetworking;


执行后可能会一直停在


Setting up CocoaPods master repo然后(很久)会出现如下错误:


[!] Failed to connect to GitHub to update the CocoaPods/Specs specs repo - Please check if you are offline, or that GitHub is down


解决办法是:


这说明CocoaPods还不能正常使用,需要更新pod,下载它的一些依赖包;在终端中输入:


$ pod setup


过一段时间之后,你会在终端中看到跟上面同样的红色的错误信息。


这说明某些环境原因导致pod更新不了,可能原因有,1)gem版本太低;2)github无法链接;3).cocoapods目录下的配置信息错误。我们可以一个一个来排除,


首先更新gem到最新版本,在终端中输入:


$ sudo gem update --system


然后检查是否可以ping通github,在终端中输入:


$ ping github.com


然后查看pob repo list:


$ pod repo list


说明Cocoapods在将它的信息下载到~/.cocoapods里;


cd到该目录里,用du -sh *命令来查看文件大小,结果显示0 repos,说明没有安装成功;


在终端输入:


cd ~/.cocoapods


进入cocoapods文件后在终端输入:du -sh *


重新执行pod setup,过一段时间后提示setup completed,在终端中输入pod list,展示出安装列表;


这样总算安装好了。接下来再一次输入:


pod search AFNetworking


输入过后它可能会报:


[!] Unable to find a pod with name, author, summary, or descriptionmatching `AFNetworking`


解决方案是:


输入:


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


后在一次输入:pod search AFNetworking


就可以咯。


2)首先定位到项目文件目录


cd 项目位置


然后添加podfile文件:vim podfile (注:在写该文件的时候要注意格式 ' ' );


进入后按i进入插入模式,进行编辑,安装官方最新的文档格式:


platform :iOS, '8.0'


target '你的项目名称' do


pod 'AFNetworking', '~> 3.0'


end


编辑完成后,按ESC退出编辑模式,最后输入:wq保存并退出文件,此时可以发现在项目目录下多了一个Podfile的文件,请注意这个文件必须与.xcodeproj在同一目录下,


最后:pod install进行安装即可


3)CocoaPods库的跳过更新安装


pod install --verbose --no-repo-update(跳过更新进行安装)


pod update --verbose --no-repo-update(跳过更新进行更新

更新cocoapods

和往常一样使用CocoaPods管理一个基于FMDB的项目类库


命令行执行


$ pod install
[!] The 'master' repo requires CocoaPods 0.32.1 -

失败,提示需要CocoaPods 0.32.1版本


查看CocoaPods版本


$ pod --version
0.29.0

确实需要更新了


命令行更新(安装)步骤【更新】
$ sudo gem update --system // 先更新gem,国内需要切换源
$ gem sources --remove https://rubygems.org/
$ gem sources -a https://ruby.taobao.org/
$ gem sources -l
/*/*/* CURRENT SOURCES /*/*/*
https://ruby.taobao.org/
$ sudo gem install cocoapods // 安装cocoapods
$ pod setup

和安装过程是一样的,再次查看版本


$ pod --version
0.39.0

微信扫一扫

第七城市微信公众平台