CocoaPod安装和使用教程
一.CocoaPods是什么?
CocoaPods是一个负责管理iOS项目中第三方开源库的工具。CocoaPods的项目源码在Github上管理。我们开发iOS项目不可避免地要使用第三方开源库,CocoaPods的出现使得我们可以节省设置和更新第三方开源库的时间,在iOS开发中经常会用到第三方库如AFNetworking,ASIHttpRequest等,在使用第三方库时,你除了要导数源码外,但是,集成这些依赖库需要我们手动去配置,还有当这些第三方库发生了更新,还需要手动去更新项目。这就显得非常麻烦。有麻烦自然有解决办法,CocoaPods就是为了解决这个问题而生的。通过CocoaPods,我们可以将第三方的依赖库统一管理起来,配置和更新只需要通过简单的几行命令即可完成。
二.CocoaPods的下载及安装
手动安装:
Macruby()Ruby的,可以在终端中输入命令行:ruby -v查看当前ruby版本。如图:
确定以后,在Terminator(也就是终端)中输入以下命令:
sudo gem install cocoapods
可能在终端中敲入这个命令之后,会发现半天没有任何反应。原因是那堵墙阻挡了cocoapods.org。
解决办法:我们可以Ruby镜像来访问cocoapods。按照下面的顺序在终端中敲入依次敲入命令:
首先,检查你的ruby源:
$gem sources -l
默认情况下,终端应该返回如下信息:
https://rubygems.org/
当然这个源在墙内是访问不到的。因此我们需要寻找一个可以在国内访问到的镜像。目前找到的是https://gems.ruby-china.org,当然随着时间的推移,未来这个镜像也有可能无法访问了,到时候就只能重新寻找了。(注意:对镜像不清楚的可以直接去https://gems.ruby-china.org查看)
确认镜像可用后,现在就要开始修改ruby源了。首先执行以下命令删除原来的ruby源:
执行命令后可在终端看见以下信息:
然后下一步添加你找到的可用的镜像源:
此时如果你再执行gem sources -l命令,就能看到当前镜像源。此时你就可以重新执行这一段开头的那句命令了:
如果一切正常,你应该能看到一段安装进度,以及最后有一条信息:
gems installed
确认看见这条信息,后先判断的CocoaPods是否可以使用,可以用CocoaPods的搜索功能验证一下。在终端中输入:
pod search AFNetworking;
执行后可能会一直停在 Setting up CocoaPods master repo然后(很久)会出现如下错误:
解决办法是:
这说明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
插件安装:
可以直接下载这里cocoapods的插件,下载完成后打开运行
其实,不管是使用命令还是使用插件,使用大致步骤都是一样的:
第一步,需要创建项目
第二步,创建Podfile文件(这个非常重要)
第三步,搜索需要用的第三方库(主要是版本号),填写到podfile文件并保存。
第四步,安装第三方库,退出,用xcworkspace文件打开(只能用这个打开,不是以前的xcodeproj文件了)。
第五步,导入头文件,开始使用。
首先,安装成功插件之后,在Xcode的Product选项里面会出现一个cocoapods的条目,如果你看到这个,说明基本已经安装成功了。
另一种方法:
Alcatraz是一个能帮你管理Xcode插件丶模版及颜色配置的工具.它可以直接集成在Xcode的图形界面中,让你感觉就像在使用Xcode自带的功能一样
使用如下的终端来安装Alcatraz:
https:/raw.github.com/supermarin/Alcatraz/master/Scripts/install 如果你不想使用Alcatraz了,可以使用如下命令来删除:
~\ 删除所有通过Alcatraz安装的安装包
~\
使用Alcatraz
安装成功后重启Xcode,就可以在Xcode的顶部菜单中找到Alcatraz,如下图所示:
单击”Package Manager”,即可启动插件列表页面,如下图所示.
相关问题链接:
http://www.jianshu.com/p/6e5c0f78200a
CocoaPods官网 :http://cocoadocs.org
Stackoverflow主页:http://stackoverflow.com/search?q=CocoaPods
Alcatraz插件下载 : https://github.com/alcatraz/Alcatra