CocoaPods的安装使用和常见问题

CocoaPods可以方便地通过Mac自带的RubyGems安装。

打开Terminal,然后键入以下命令:

$ sudo gem install cocoapods

执行完这句如果报告以下错误:

ERROR:  Could not find a valid gem 'cocoapods' (>= 0), here is why:

Unable to download data fromhttps://rubygems.org/- Errno::ETIMEDOUT: Operation timed out - connect(2) (https://rubygems.org/latest_specs.4.8.gz)

ERROR:  Possible alternatives: cocoa pods

这是因为ruby的软件源rubygems.org因为使用亚马逊的云服务,被我天朝屏蔽了,需要更新一下ruby的源,过程如下:

$ gem sources -l  (查看当前ruby的源)

$ gem sources --removehttps://rubygems.org/

$ gem sources -ahttps://ruby.taobao.org/

$ gem sources -l

如果gem太老,可以尝试用如下命令升级gem

$ sudo gem update --system

升级成功后会提示: RubyGems system software updated

然后重新执行安装下载命令

$ sudo gem install cocoapods

这时候应该没什么问题了(如果报告Operation not permitted...之类的错误,请参考第五节:常见问题5,如果报告activesupport requires Ruby version >= 2.2.2这样的错误,请参考第五节:常见问题6)

接下来进行安装,执行:

$ pod setup

Terminal会停留在 Setting up CocoaPods master repo 这个状态一段时间,是因为要进行下载安装,而且目录比较大,需要耐心等待一下.如果想加快速度,可使用cocoapods的镜像索引.(文章末尾附使用镜像索引的方法)

安装成功后,你会看到:


Cocoapods的使用

进入工程所在的目录(工程根目录)

执行命令 touch Podfile

这句是说新建一个名为Podfile的文件(不能写成别的名字,也可以自己在工程根目录里面直接新建)

然后对改文件进行编辑,执行命令 open -e Podfile

第一次执行这个命令,会有一个空白文件打开,可以先放在一边,

Podfile文件的格式应该如下:



# Uncomment the next line to define a global platform for your project

# platform :ios, '8.0'

target ‘eee’ do

#本地库

pod ‘FMDB’,’2.7.2’

use_frameworks!

end




需要注意的几点:platform那一行,ios三个字母都要小写,而且与前面的冒号之间不能有间隔,后面的版本号也可以不写,但是有些开源库对版本是有要求的,比如要在6.0以上才能运行,遇到这样的开源库就需要写上版本号。

platform下面就是Cocoapods需要集成的开源库,根据你的需要确定集成那些库。

举个例子:

我要集成AFNetworking这个库类,需要在Cocoapods里面先搜索是否有需要的库,可以在Terminal中输入:

pod search AFNetworking

回车之后就可以看到和你搜索的关键字相关的一些库类,如图:


其中第一个就是我们需要的,把pod ‘AFNetworking’, ‘~>2.5.3’

那一行复制到我们的Podfile文件中,保存修改。

然后在Terminal中执行 :

pod install

这样,AFNetworking就已经下载完成并且设置好了编译参数和依赖,以后使用的时候切记如下两点:

1.从此以后需要使用Cocoapods生成的.xcworkspace文件来打开工程,而不是使用以前的.xcodeproj文件

2.每次更改了Podfile文件,都需要重新执行一次pod update命令

ps:当执行pod

install之后,除了Podfile,还会生成一个名为Podfile.lock的文件,它会锁定当前各依赖库的版本,之后即使多次执行pod

install也不会更改版本,只有执行pod

update才会改变Podfile.lock.在多人协作的时候,这样可以防止第三方库升级时候造成大家各自的第三方库版本不一致。所以在提交版本的时候不能把它落下,也不要添加到.gitignore中.


常见问题

1.

[!] InvalidPodfilefile: undefined local variable or method `en_US' for #. Updating CocoaPods might fix the issue.

原因:单引号格式,可能是手动输入导致

解决办法:系统偏好设置-键盘-文本-将“使用智能引号和破折号”一项取消勾选-再将podfile里面的单(双)引号修改一下

2.ArgumentError - invalid byte sequence in US-ASCII

原因:字符集错误

解决办法:

使用locale命令查看当前的字符集,如果都是zh,需要执行以下命令:

export LC_ALL=en_US.UTF-8

export LANG=en_US.UTF-8

然后再使用locale命令查看,已经改过来了

[!] TheYMTea [Debug]target overrides theOTHER_LDFLAGSbuild setting defined in `Pods/Target Support Files/Pods/Pods.debug.xcconfig'. This can lead to problems with the CocoaPods installation

Use the$(inherited)flag, or

Remove the build settings from the target.

[!] TheYMTea [Release]target overrides theOTHER_LDFLAGSbuild setting defined in `Pods/Target Support Files/Pods/Pods.release.xcconfig'. This can lead to problems with the CocoaPods installation


-Usethe`$(inherited)`flag,or

- Remove thebuildsettingsfromthe target.


原因:我是在已有项目中集成Cocoapods的时候遇到这个问题,原因是项目 Target 中做了一些设置,CocoaPods 也做了默认的设置,如果两个设置结果不一致,就会造成问题。

解决方法:我想要使用 CocoaPods 中的设置,分别在我的项目中定义PODS_ROOT和Other Linker Flags的地方(build settings),把他们的值用$(inherited)替换掉,进入终端,执行 pod update

警告没了,回到 Xcode,build通过。

网上还流行另外一种简单粗暴的方法:点击项目文件 project.xcodeproj,右键显示包内容,用文本编辑器打开project.pbxproj,删除OTHER_LDFLAGS的地方,保存(这种我没试过)

4.

[!] Oh no, an error occurred.

It appears to have originated from your Podfile at line 2.

Search for existing GitHub issues similar to yours:

https://github.com/CocoaPods/CocoaPods/search?q=%2FUsers%2Fxiao6%2FMusic%2FGI06%E5%AE%9E%E8%AE%AD%E8%8A%B8%E8%8C%97%E8%8C%B6%E5%8F%B6%2FYMTea%2FPodfile%3A2%3A+syntax+error%2C+unexpected+%27%3A%27%2C+expecting+end-of-input%0Aplatform+%3A+ios%2C+%277.0%27%0A++++++++++%5E&type=Issues

If none exists, create a ticket, with the template displayed above, on:

https://github.com/CocoaPods/CocoaPods/issues/new

Be sure to first read the contributing guide for details on how to properly submit a ticket:

https://github.com/CocoaPods/CocoaPods/blob/master/CONTRIBUTING.md

Don't forget to anonymize any private data!

原因:这个问题比较蛋疼,弄了好久,仔细看发现就是因为Podfile文件里面 platform 那一行 冒号和ios之间多了一个空格。。。。其实这个错误在报错的时候ruby已经给出了,只是一开始没有好好看:


5.(2016.4.14更新)

如果在执行sudo gem install cocoapods的时候报以下错误:

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

Operation not permitted - /usr/bin/pod

并且你的操作系统是EI Caption,可是尝试使用以下方法来代替上面的安装命令:

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

6.(2016.8.4更新)

在执行sudo gem install cocoa pods指令安装的时候提示错误:

ERROR: Error installing cocoapods:

activesupport requires Ruby version >= 2.2.2.

解决方法: 由于你的ruby版本偏低,需要升级你电脑上的ruby.

在命令行输入:ruby -v来查看当前ruby的版本.确定版本是低于2.2.2后就可以开始进行ruby的升级.

一般通过rvm来升级ruby.

具体升级ruby的方法可以参考:

http://blog.csdn.net/lissdy/article/details/9191351这个链接中的内容(大体操作过程相同,只是要安装的版本号的差异,大家也可以自行查找其它资料来升级自己的ruby)

在执行rvm install 2.2.4的过程中,我还出现了一些报错,标题是"requirements_osx_brew_update_system ruby-2.2.4"后面有一些详细的错误日志,像下面这样:

ruby更新错误.png

从日志内容可以看出大概意思就是说我在更新brew的过程中出现了一些错误.(然后你的也可能有其他报错,只要根据日志提示的错误内容采取相应的措施就好).所以接下来我还更新了brew:

brew update--更新homeBrew自己

我又报错了:The /usr/local directory is not writable.如下:

homeBrew更新报错.png

这是说,我那个路径不可写,按照上面说的,指令也告诉我们了:

sudo chown -R $(whoami):admin /usr/local

输入密码后重新执行brew update,就出现了一系列感觉要成功的进度提示等,最后提示Already up-to-date的时候,brew本身就更新好了(这个过程比较久).

接着用brew outdated命令查看brew下哪些软件可以进行升级.

然后brew upgrade命令用来升级所以可以升级的软件.

最后记得用brew cleanup来清理不需要的版本及其安装包缓存.

截止目前,brew也被我们更新好了.

接下来回到ruby更新,重新执行rvm install 2.2.4,又是漫长的等待后,一行行绿色的字表示ruby也安装完成了,这时候再看看ruby的版本ruby -v:

ruby更新后版本.png

ok,升级好了.

7.(2016.8.4更新)

执行pod setup的时候,出现报错:

Cloning into 'master'...

error: RPC failed; result=56, HTTP code = 200

fatal: The remote end hung up unexpectedly

fatal: early EOF

fatal: index-pack failed

如图:

pod setup报错.png

这个是用于在执行pod setup命令的时候,里面会执行从github上面clone资源到本地的语句,但是要clone的东西太大了,超过的git限制的大小.尝试执行以下语句把默认的限制变大:(52428000=500×1024×1024,即500M)

git config http.postBuffer 524288000

之前git中的配置是没有这一项的,执行完以上语句后输入git config -l可以看到配置项的最下面多出了一行我们刚刚配置的内容.

接下来再执行pod setup试试看吧.


b  终端中,cd到项目总目录(注意:包含PodTest文件夹、PodTest.xcodeproj、PodTestTest的那个总目录)

[objc] view plaincopyprint?在CODE上查看代码片派生到我的代码片

cd /Users/lucky/Desktop/PodTest

c  建立Podfile(配置文件)

接着上一步,终端输入 vim Podfile

键盘输入 i,进入编辑模式,输入

platform :ios, '7.0'

pod 'MBProgressHUD', '~> 0.8'

然后按Esc,并且输入“ :”号进入vim命令模式,然后在冒号后边输入wq

注意:键盘输入 :后,才能输入wq。回车后发现PodTest项目总目录中多一个Podfile文件

激动人心的时刻到了:确定终端cd到项目总目录,然后输入 pod install,等待一会,大约3分钟。

查看项目根目录:

注意:现在打开项目不是点击 PodTest.xodeproj了,而是点击 PodTest.xcworkspace

打开项目后看到项目结构并且测试一下:

运行结果:

补充:

1、CocoaPods的基本安装及使用都详细的说明了,但还有一些补充,当需要同时导入多个第三方时候怎么办 ?

这就需要修改Podfile了,就是用vim编辑的那个保存在项目根目录中的文件,修改完了Podfile文件,需要重新执行一次pod install命令。

例如:

platform :ios

pod 'JSONKit',      '~> 1.4'

pod 'AFNetworking',  '~> 2.0'



退出编辑vim      输入pod install

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 195,242评论 5 461
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 82,138评论 2 372
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 142,412评论 0 323
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,380评论 1 266
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,221评论 4 357
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,203评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,607评论 3 384
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,292评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,581评论 1 292
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,650评论 2 311
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,405评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,268评论 3 313
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,646评论 3 299
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,942评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,226评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,601评论 2 342
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,795评论 2 335

推荐阅读更多精彩内容