CocoaPods的安装与简单使用
一, CocoaPods是什么?
每种语言发展到一个阶段,就会出现相应的依赖管理工具。随着iOS开发者的增多,业界出现了为iOS程序提供依赖管理的工具,它的名字叫做:CocoaPods.
CocoaPods现在已经成为iOS开发的依赖管理标准工具。开发iOS项目不可避免地要使用第三方库,CocoaPods的出现使得我们可以节省设置和更新第三方开源库的时间。
在没有使用CocoaPods以前,我们需要:
1. 把这些第三方开源库的源代码文件复制到项目中,或者设置成git的submodule。
2. 对于这些开源库通常需要依赖系统的一些framework,我需要手工地将这些framework分别增加到项目依赖中,比如通常情况下,一个网络库ASIHttpRequest(AFNetworking)就需要增加以下framework: CFNetwork, SystemConfiguration, MobileCoreServices, CoreGraphics, zlib。
3. 对于某些开源库,我还需要设置-licucore或者-fno-objc-arc等编译参数
4. 管理这些第三方库的更新。
这些体力活虽然简单,但毫无技术含量并且浪费时间。在使用CocoaPods之后,我只需要将用到的第三方开源库放到一个名为Podfile的文件中,然后执行pod install。CocoaPods就会自动将这些第三方开源库的源码下载下来,并且为我的工程设置好相应的系统依赖和编译参数
二, CocoaPods下载和安装?
安装方式异常简单,在安装CocoaPods之前,首先要在本地安装好Ruby环境。Mac下都自带ruby,使用ruby的gem命令即可下载安装:
$sudo gem install cocoapods
如果你的gem太老,可能也会有问题,可以尝试用如下命令升级gem:
$sudo gem update —-system
另外,ruby的软件源https://rubygems.org因为使用的是亚马逊的云服务,所以被墙了,需要更新一下ruby的源,使用如下代码将官方的ruby源替换成国内淘宝的源:
$gem sources —-remove https://rubygems.org/
等有反应之后再敲入以下命令:
$gem sources —a https://ruby.taobao.org/
为了验证你的Ruby镜像是并且仅是taobao,可以用以下命令查看:
$gem sources -l
上面所有的命令完成这时候,你再次在终端中运行:
$sudo gem install cocoapods
等上一分钟(根据网速),最后再执行下面的命令:
$pod setup
成功后, CocoaPods就可以在你本地下载并且安装好了。
还有一点需要注意,$pod setup在执行时,会输出Setting up CocoaPods master repo,但是会等待比较久的时间。这步其实是Cocoapods在将它的信息下载到~/.cocoapods目录下,如果你等太久,可以试着cd到那个目录,用du -sh *来查看下载进度。你也可以参考本文接下来的使用cocoapods的镜像索引一节的内容来提高下载速度。
使用CocoaPods的镜像索引
所有的项目的Podspec文件都托管在https://github.com/CocoaPods/Specs。第一次执行pod setup时,CocoaPods会将这些podspec索引文件更新到本地的~/.cocoapods/目录下,这个索引文件比较大。所以第一次更新时非常慢,更新了将近1个小时才完成。
一个叫akinliu的朋友在gitcafe和oschina上建立了CocoaPods索引库的镜像,因为gitcafe和oschina都是国内的服务器,所以在执行索引更新操作时,会快很多。如下操作可以将CocoaPods设置成使用gitcafe镜像:
$pod repo remove master
$pod repo add master https://gitcafe.com/akuandev/Specs.git
$pod repo update
将以上代码中的https://gitcafe.com/akuandev/Specs.git替换成http://git.oschina.net/akuandev/Specs.git即可使用oschina上的镜像。
三, CocoaPods的使用?
好了,安装好CocoaPods之后,接下来就是使用它。所幸,使用CocoaPods和安装它一样简单,也是通过一两行命令就可以搞定。
1,利用CocoaPods,在项目中导入AFNetworking类库
AFNetworking类库在GitHub地址是:https://github.com/AFNetworking/AFNetworking
为了确定AFNetworking是否支持CocoaPods,可以用CocoaPods的搜索功能验证一下。在终端中输入:
$pod search AFNetworking
过几十秒钟之后,你会在终端中看到关于AFNetworking类库的一些信息。
接下来创建Xcode工程,我们在项目中加入CocoaPods的支持;
CocoaPods将会自动下载AFNetworking并加入到工程当中呢,那如何来做呢? 你创建一个Podfile文件(注意,一定得是这个文件名,而且没有后缀),然后在里面添加你需要下载的类库,也就是告诉CocoaPods,“某某和某某和某某某,快到碗里来!”。每个项目只需要一个Podfile文件。
好吧,废话少说,我们先创建这个神奇的Podfile。在终端中进入你项目所在目录(cd命令)
$cd /Users/ijeff/Desktop/cocoaPodsDemo1
然后在当前目录下,利用vim创建Podfile,运行:
$vim Podfile
然后在Podfile文件中输入以下文字:
platform:ios,'7.0'
pod"AFNetworking","~> 2.0"
这两句文字的意思是,当前AFNetworking支持的平台: ios,
要下载的AFNetworking版本是2.0。
然后保存退出。vim环境下,保存退出命令是:
$:wq
这时候,你会发现你的项目目录中,出现一个名字为Podfile的文件,而且文件内容就是你刚刚输入的内容。
(注意,Podfile文件要在项目文件夹的根目录下。)
这时候,你就可以利用CocoaPods下载AFNetworking类库了。还是在终端中的当前项目目录下,运行以下命令:(--verbose --no-repo-update)
$pod install
运行完$pod install命令后会产生几个新文件。你会发现多了两个文件“.xcworkspace”, “Podfile.lock”和一个文件夹“Pods”。
注意: 以后打开项目就用.xcworkspace打开,而不是之前的.xcodeproj文件。
至此,CocoaPods已经在你的项目中植入,管理了一个第三方库AFNetworking。上面写了这么多,其实过程是十分简单的。总结一下就是:
1. 先在项目中创建Podfile,Podfile的内容是你想导入的类库。一般类库的原作者会告诉你导入该类库应该如何写Podfile;
2. 运行命令:$pod install
使用$pod install进行安装时如果出现如下错误:
$ podinstall
Analyzing dependencies
[!] Unabletofind a specificationfor`AFNetworking (~> 2.0)`
尝试解决办法:
把当前Pod的目录清理一下就行了。在终端执行以下命令:
pod repo remove master
pod setup
setup成功后执行install
2,正确编译运行一个包含CocoaPods类库的项目
在网上下载的项目如果使用了CocoaPods,则有时候会出现很多错误,基本都是说你编译的这份代码找不到某某头文件,这就意味着你要成功编译就必须先导入一些第三方类库。同时你会发现在项目的根目录文件夹下面有三个跟CocoaPods相关的文件(文件夹):Podfile,Podfile.lock和Pods
这时候,打开终端,进入项目所在的根目录,也就是和Podfile在同一目录下,输入以下命令(由于已经有Podfile,所以不需要再创建Podfile):
$pod update
执行完后,再回到工程根目录文件夹看一看,会看到多了一个文件.xcworkspace,最后就点击该文件打开项目即可。
附加:
阿里巴巴官方提供的方法:
1.如何使用?
使用终端命令行进行安装:
$ gem sources --add https://ruby.taobao.org/ --remove https://rubygems.org/ $ gem sources -l *** CURRENT SOURCES ***
注意:请确保只有#ruby.taobao.org
然后执行:
$ gem install rails
等待安装完成即可。