CocoaPods使用教程
一、什么是CocoaPods
每种语言发展到一个阶段,就会出现相应的依赖管理工具,例如 Java 语言的 Maven,nodejs 的 npm。随着 iOS 开发者的增多,业界也出现了为 iOS 程序提供依赖管理的工具,它的名字叫做:CocoaPods。
CocoaPods项目的源码 在 Github 上管理。该项目开始于 2011 年 8 月 12 日,经过多年发展,现在已经成为 iOS 开发事实上的依赖管理标准工具。开发 iOS 项目不可避免地要使用第三方开源库,CocoaPods 的出现使得我们可以节省设置和更新第三方开源库的时间。
二、为什么要使用CocoaPods
在使用CocoaPods之前,开发项目需要用到第三方开源库的时候,我们需要
- 把开源库的源代码复制到项目中
- 添加一些依赖框架和动态库
- 设置-ObjC,-fno-objc-arc等参数
- 管理他们的更新
在使用CocoaPods后,我们只需要把用到的开源库放到一个名为Podfile的文件中,然后执行pod install就可以了,Cocoapods就会自动将这些第三方开源库的源码下载下来,并且为我们的工程设置好响应的系统依赖和编译参数。
三、CocoaPods的原理
CocoaPods的原理是将所有的依赖库都放到另一个名为Pods的项目中,然后让主项目依赖Pods项目,这样,源码管理工作都从主项目移到了Pods项目中。Pods项目最终会编译成一个名为libPods.a的文件,主项目只需要依赖这个.a文件即可。
四、CocoaPods的安装
CocoaPods可以方便地通过Mac自带的RubyGems安装。
执行命令: sudo gem install cocoapods
五、Cocoapods的使用
随便以一种方式新建一个名为Podfile的文件放到你的工程根目录下(不能写成别的名字,也可以自己在工程根目录里面直接新建)
Podfile文件内容的格式应该如下:
# 代表注释
# 将下面的注释打开,注明你的开发平台及版本, ‘9.0’不写即为最新版本
# platform :ios, '9.0'
target '06-testCocoaPods' do
# 如果使用swift开始,或者动态库开发,将下面的注释打开
# use_frameworks!
# 在 do 和 end 中间添加需要导入的库
pod 'AFNetworking', '~> 2.5.3' #('~> 2.5.3'为版本号,忽略不写即为最新版本)
pod 'SDWebImage' #代表使用最新版本
end
然后在Terminal进入工程所在的根目录(工程根目录)中执行 :
pod install
这样,AFNetworking和SDWebImage就已经下载完成并且设置好了编译参数和依赖,以后使用的时候切记如下两点:
- 从此以后需要使用Cocoapods生成的 .xcworkspace文件来打开工程,而不是使用以前的.xcodeproj文件
- 每次更改了Podfile文件,都需要重新执行一次pod update命令
查找第三方库:
你如果不知道 cocoaPods 管理的库中,是否有你想要的库,那么你可以通过 pod search 命令进行查找,以下是我用 pod search json 查找到的所有可用的库:
可以在Terminal中输入:
** pod search AFNetworking
**
六、podfilelock
podfilelock
-
Podfile.lock
文件最大得用处在于多人开发。对于没有在Podfile
中指定Pods依赖库版本的写法,如下:
pod 'SDWebImage'
该句话用于获取当前SDWebImage
这个Pods依赖库的最新版本。 - 当团队中的某个人执行完
pod install
命令后,生成的Podfile.lock
文件就记录下了当时最新Pods依赖库的版本,这时团队中的其它人check下来这份包含Podfile.lock
文件的工程以后,再去执行pod install
命令时,获取下来的Pods依赖库的版本就和最开始用户获取到的版本一致。 - 如果没有
Podfile.lock
文件,后续所有用户执行pod install
命令都会获取最新版本的SDWebImage
,这就有可能造成同一个团队使用的依赖库版本不一致,这对团队协作来说绝对是个灾难! - 在这种情况下,如果团队想使用当前最新版本的
SDWebImage
依赖库,有两种方案:
更改Podfile,使其指向最新版本的SDWebImage依赖库;
执行pod update命令;
鉴于Podfile.lock文件对团队协作如此重要,我们需要将它添加到版本管理中。