CocoaPods的使用与安装

什么是CocoaPods

CocoaPods是开发 OS X 和 iOS 应用程序的一个第三方库的依赖管理工具,而其本身是利用ruby的依赖管理gem进行构建的。因此,在解析整合过程中,最重要的几个gems分别是:CocoaPods/CocoaPods, CocoaPods/Core, 和 CocoaPods/Xcodeproj。
在我们的工程里面会用到JSONKit、AFNetWorking等第三方开源库,首次在工程中引入这些第三方库的时候,会涉及许多配置,尤其是在build phases和linker flags配置中过程中,会引起许多人为因素的错误。CocoaPods的出现简化了这一切,并且可以通过CocoaPods查找新的第三方库。

CocoaPods的工作原理

CocoaPods的原理是将所有的依赖库都放到另一个名为Pods的项目中,然后让主项目依赖Pods项目,这样,源码管理工作都从主项目移到了Pods项目中。Pods项目最终会编译成一个名为libPods.a的文件,主项目只需要依赖这个 .a文件即可。

CocoaPods的安装

上面已经提到了,CocoaPods是利用Ruby的依赖管理gem进行构建,因此安装CocoaPods需要在ruby的环境下。

1.Ruby环境搭建

Mac OS是自带ruby环境的,但是保险起见,还是需要更新一下。
a.查看当前ruby版本
打开Mac的terminal 输入ruby -v代码如下

$ ruby -v
ruby 2.0.0p645 (2015-04-13 revision 50299) [universal.x86_64-darwin15](#)

b.更换ruby源
终端输入如下命令(ruby的软件源rubygems.org因为使用的亚马逊的云服务,所以被墙了,需要更新一下ruby的源,国内常用的镜像服务有淘宝阿里云的,山东理工大学的,一般使用淘宝的)
gem sources --remove https://rubygems.org/
gem sources -a https://ruby.taobao.org/
gem sources -l (用来检查使用替换镜像位置成功)
代码如下

$ gem sources --remove https://rubygems.org/
https://rubygems.org/ removed from sources
$ gem sources -a https://ruby.taobao.org/
https://ruby.taobao.org/ added to sources
$ gem sources -l
*** CURRENT SOURCES ***

http://rubygems-china.oss.aliyuncs.com
https://ruby.taobao.org/

2.升级gem

sudo gem update --system
升级成功后,代码如下

升级成功截图

3.下载安装CocoaPods

安装CocoaPods(OS X 10.11以前)

  • sudo gem install cocoapods
    安装CocoaPods(10.11后苹果升级了安全策略)
  • sudo gem install -n /usr/local/bin cocoapods
    安装更新后,会有 gem installed提示

所有的项目的Podspec文件都托管在https://github.com/CocoaPods/Specs。第一次执行pod setup时,CocoaPods会将这些podspec索引文件更新到本地的 /.cocoapods/目录下,这个索引文件比较大,有80M左右。所以第一次更新时非常慢,一般更新了将近1个小时才完成。
一个叫akinliu的朋友在gitcafe和oschina上建立了CocoaPods索引库的镜像,因为gitcafe和oschina都是国内的服务器,所以在执行索引更新操作时,会快很多。如下操作可以将CocoaPods设置成使用gitcafe镜像:
1.移除原有服务器

完成后,执行操作:

pod setup

执行结束后代码如下图:

setup成功

至此,CocoaPods就完全安装结束,so easy!

CocoaPods的使用

1.新建Podfile文件

使用时需要在你的项目根目录下新建一个名为Podfile的文件,将依赖的库名字依次列在文件中即可

promote: lhl$ cd /Users/chengmei/Desktop/Test 
promote:Test lhl$ touch Podfile

这时候,在你的工程文件中就新建了一个名为Podfile的文件。

2.编辑Podfile文件

用文本编辑器打开刚才新建的Podfile文件,此时的文件应是空白的,Podfile 文件的格式应该类似以下:

platform :ios, '7.0'
pod 'AFNetworking', '> 3.0.4'
pod 'LCTabBarController', '> 1.2.2'
pod 'LCBannerView'

注意
***a. platform 那一行,ios 三个字母都要小写,而且与前面的冒号之间不能有间隔。
b. 后面的版本号也可以不写,但是有些开源库对版本是有要求的,比如要在 iOS 7.0 以上才能运行,遇到这样的开源库就需要写上版本号。
c. platform 下面就是 CocoaPods 需要集成的开源库,根据你的需要确定集成成些库。


3.查找所需要的类库

例如,我们需要在工程文件中添加AFNetworking,首先需要在 CocoaPods 里面先搜索是否有需要的库,在 Terminal 中输入:

pod search AFNetworking

所显示代码如下:


pod 'AFNetworking', '> 3.0.4'

就是需要我们在Podfile文件里面写的,把它复制,粘贴进去,并保存。

4.执行导入命令

$ cd /Users/chengmei/Desktop/Test
$ pod install

导入成功后,如下截图所示

导入成功

pod install命令执行成功后,会看到工程目录下多出CocoaPodsTest.xcworkspace、Podfile.lock文件和Pods目录。再看看刚才执行完pod install命令打印出来的内容的最后一行:

[!](#) Please close any current Xcode sessions and use `Test.xcworkspace` for this project from now on.

提示我们从现在起,我们需要使用CocoaPodsTest.xcworkspace文件来开发。

5.第三方库更新与添加

当需要添加第三方库时,只需要直接在Podfile里面添加第三方库信息,在terminal里面导入执行命令:

$ cd /Users/chengmei/Desktop/Test
$ pod update

即可添加并更新成功。
至此,我们CocoaPods的安装与使用就全部结束,往后我们只需在.xcworkspace文件里面编写即可。

遇到过的坑

  1. 首先就是系统升级成10.11后,由于苹果加强了安全策略,原来的sudo gem install cocoapods命令不再起作用,在10.11以前的系统中任然适用。10.11后需要适用命令sudo gem install -n /usr/local/bin cocoapods
遇到的坑

这个问题折腾我好久,最后发现是在ios, ‘7.0’这个逗号后面我多输入了一个空格。

3

[!] Invalid Podfile file: undefined local variable or method 'en_US' for #<Pod::Podfile:0x00000102a5d8b0>. Updating CocoaPods might fix the issue.

此错误也是常见的,原因:单引号格式,可能是手动输入导致
解决办法:前往 系统偏好设置 - 键盘 - 文本 - 将“使用智能引号和破折号”一项取消勾选 - 再将 Podfile 里面的单(双)引号修改一下。
如果遇到了神奇的报错,执行下面的命令

$ sudo gem update --system
$ sudo gem install cocoapods
$ pod setup

重装吧

更多

1、pod install提速
每次执行pod install和pod update的时候,cocoapods都会默认更新一次spec仓库。这是一个比较耗时的操作。在确认spec版本库不需要更新时,给这两个命令加一个参数跳过spec版本库更新,可以明显提高这两个命令的执行速度。

pod install --verbose --no-repo-update
pod update --verbose --no-repo-update

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

推荐阅读更多精彩内容