CocoaPods安装配置

[ 22 天前 ]

一、CocoaPods简介
CocoaPods负责管理iOS项目中第三方框架。CocoaPods的项目源码在Github上管理。项目从2011年8月12日开始,CocoaPods的出现使得我们可以节省设置和更新第三方开源库的时间。(练习时为了速度一般我都是直接导入工程中,个人比较讨厌写纯代码在Podfile文件中)

二、开始安装
安装需要用到Ruby,虽然Mac自带了Ruby,不过版本有点老了,最好更新一下
因为Ruby的软件源rubygems.org被屏蔽了,所以先要更换源

gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/

查看下源路径是否更换了

gem sources -l

更新Ruby

sudo gem update --system

接下来安装Cocoapods了

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

安装完后你可以输入下面的命令查看是否成功

pod --version

安装完cocoapods后进行最后一步,设置仓库,就是把所有上传到cocoapods的第三方框架下载每个版本和网络地址以及一些其他描述信息到本地

pod setup

下载完就大功告成了

三、开始使用
设置完成后就可以开始使用了,先在xcode中创建一个名为“test”的Project,然后创建一个single View Application,终端中切换至工程目录(可直接将工程目录拖入终端),接下来编辑并创建Podfile文件(以Alamofire为例),在终端输入

vim Podfile

进入Podfile后输入i编辑状态(可以查看左下角有个INSERT),进入输入下面命令

platform :ios, '9.0'
use_frameworks!

target 'test' do
  pod 'Alamofire', '~> 4.7'
end

ios, '9.0'是指定所支持系统的最低版本
target 'test' do中test为工程名
写完后按Esc 然后:wq 意思是保存并退出
接下来会自动生成Podfile文件,并且创建.xcworkspace,接着在终端输入

pod install

以后就可以打开.xcworkspace,而不再是打开.xcodeproj文件,来使用你的工程了

四、如何正确编译运行一个包含CocoPods类库的项目
你也许曾经遇到过(特别是新手iOS开发者)这种情况,好不容易在GitHub上找到一份代码符合自己想需求,兴冲冲下载下来,一编译,傻眼了,发现有各种各样错误。一看,原来是缺失了各种其他第三方类库。这时候莫慌,你再仔细一看,会发现你下载的代码包含了Podfile。没错,这意味着你可以用CocoaPods很方便下载所需要的类库。
这时候,打开终端,进入工程所在的目录,也就是和Podfile在同一目录下,和上面第三步中一样,输入以下命令(由于已经有Podfile,所以不需要再创建Podfile):

pod update

过几秒(也许需要十几秒,取决于你的网络状况)之后,完成。

注意,这里有个小问题,如果刚刚你不是输入pod update,而是输入pod install,会发现类库导入不成功,并且终端出现错误提示
这里的意思大概是Podfile文件过期,类库有升级,但是Podfile没有更改。pod install只会按照Podfile的要求来请求类库,如果类库版本号有变化,那么将获取失败。但是 pod update会更新所有的类库,获取最新版本的类库。而且你会发现,如果用了 pod update,再用 pod install 就成功了。