一、什么是CocoaPods
CocoaPods是iOS项目的依赖管理工具,该项目源码在Github上管理。开发iOS项目不可避免地要使用第三方开源库,CocoaPods的出现使得我们可以节省设置和第三方开源库的时间。
在使用CocoaPods之前,开发项目需要用到第三方开源库的时候,我们需要
1.把开源库的源代码复制到项目中
2.添加一些依赖框架和动态库
3.设置-ObjC,-fno-objc-arc等参数
4.管理他们的更新
在使用CocoaPods后,我们只需要把用到的开源库放到一个名为Podfile的文件中,然后执行pod install.Cocoapods就会自动将这些第三方开源库的源码下载下来,并且为我们的工程设置好响应的系统依赖和编译参数。
二、CocoaPods的原理
CocoaPods的原理是将所有的依赖库都放到另一个名为Pods的项目中,然后让主项目依赖Pods项目,这样,源码管理工作都从主项目移到了Pods项目中。Pods项目最终会编译成一个名为libPods.a的文件,主项目只需要依赖这个.a文件即可。
三.为什么需要CocoaPods?
在进行iOS开发的时候,总免不了使用第三方的开源库,比如AFNetworking、SDWebImage、SVProgressHUD等等。使用这些库的时候通常需要:
1.下载开源库的源代码并引入工程
2.向工程中添加开源库使用到的framework
3.解决开源库和开源库以及开源库和工程之间的依赖关系、检查重复添 加的framework等问题
4.如果开源库有更新的时候,还需要将工程中使用的开源库删除,重新执行前面的三个步骤,顿时头都大了。。。
自从有了CocoaPods以后,这些繁杂的工作就不再需要我们亲力亲为了,只需要我们做好少量的配置工作,CocoaPods会为我们做好一切!
四.安装CocoaPods
CocoaPods是用Ruby实现的,要想使用它首先需要有Ruby的环境。幸运的是OS X系统默认的已经可以运行Ruby了,因此我们只需要执行以下命令:
更换源:
Gem是一个管理Ruby库和程序的标准包,它通过Ruby Gem(如http://rubygems.org/)源来查找、安装、升级和卸载软件包
1.移除掉原有的源(服务器在国外,速度较慢)
gem sources --remove https://rubygems.org
2.等有反应之后再敲入以下命令(添加国内的源)(前段时间,taobao.org源统一换成https协议了,请注意)
gem sources -a https://ruby.taobao.org
3.验证是否替换成功
gem sources -l
2.更新升级gem:
gem是管理Ruby库和程序的标准包,如果它的版本过低也可能导致安装失败,解决方案自然是升级gem,执行下述命令即可:
更新升级
sudo gemupdate--system
3.安装CocoaPods:
sudo gem install cocoapods
4.更换repo镜像为国内服务器:
1.移除原有服务器
pod repo remove master
2.添加境内服务器(建议使用第一个)
pod repo add master https://gitcafe.com/akuandev/Specs.git
(开源中国较慢)
pod repo add master http://git.oschina.net/akuandev/Specs.git
四.使用CocoaPods
如果之前做的一切顺利,接下来就可以体验体验CocoaPods的神奇之处了,需要经过以下几步:
// 初始化
pod setup
// 更新
pod repo update
// 搜索
pod search mjrefresh
copy 所需库的版本号等信息
3.新建Podfile:
cd /Users/shiyunlei/Desktop/CocoapodsSample
(进入工程目录,cd后面的是工程的路径)
进入到工程的根目录下,使用
pod init
创建空白的Podfile文件,创建完毕的目录结构如下图
使用xcode打开这个文件
platform :ios, '8.0' use_frameworks! pod 'MJRefresh', '~> 3.1.0'
然后在终端输入命令安装相应的第三方类库
$pod MJRefresh
因为这个过程需要下载相应的类库,所以时间和网速有关。
这个时候会看到之后打开工程都需要从类型为工程名.xcworkspace文件打开。
platform:ios,'8.0'pod'框架名字'pod'框架名字','~> 版本号'
// 1.安装第三方框架pod install --verbose --no-repo-update// 2.升级第三方框架pod update
完成后,我们需要使用CocoaPodsTest.xcworkspace文件来开发。
对于工程发生的变化,有几点需要说明:
第三方库会被编译成静态库供我们正真的工程使用
CocoaPods会将所有的第三方库以target的方式组成一个名为Pods的工程,该工程就放在刚才新生成的Pods目录下。整个第三方库工程会生成一个名称为libPods.a的静态库提供给我们自己的CocoaPodsTest工程使用。
我们的工程和第三方库所在的工程会由一个新生成的workspace管理
为了方便我们直观的管理工程和第三方库,CocoaPodsTest工程和Pods工程会被以workspace的形式组织和管理,也就是我们刚才看到的CocoaPodsTest.xcworkspace文件。
原来的工程设置已经被更改了,这时候我们直接打开原来的工程文件去编译就会报错,只能使用新生成的workspace来进行项目管理。
以后使用CocoaPods过程中出现了莫名其妙的问题,执行下面命令
-sudo gem update --system-sudo gem install cocoapods-pod setup
升级10.11后,运行pod命令出现:
-bash: pod: command not found
解决办法:
sudo gem install -n /usr/local/bin cocoapods
之后pod命令可以使用了。
如果pod update / pod install 卡在:
Updating local specs repositories
等待即可,或者
可以使用 “pod install --verbose --no-repo-update” 进行下载,原因可能x被墙。
pod install --verbose --no-repo-update
即可。