一.CocoaPods简介
*CocoaPods是开发OS X和iOS应用程序的一个第三方库的依赖管理工具。利用CocoaPods,可以定义自己的依赖关系(称作pods
),并且随着时间的变化,以及在整个开发环境中对第三方库的版本管理非常方便。
二.CocoaPods作用
CocoaPods背后的理念主要体现在两个方面。
1.首先,在工程中引入第三方代码会涉及到许多内容。针对Objective-C初级开发者来说,工程文件的配置会让人很沮丧。在配置buildphases和linker flags过程中,会引起许多人为因素的错误。CocoaPods简化了这一切,它能够自动配置编译选项。
2.其次,通过CocoaPods,可以很方便的查找到新的第三方库。当然,这并不是说你可以简单的将别人提供的库拿来拼凑成一个应用程序。它的真正作用是让你能够找到真正好用的库,以此来缩短我们的开发周期和提升软件的质量。
三.使用CocoaPods
1.安装
一、CocoaPods安装: Mac下自带ruby,使用ruby的gem命令即可下载安装:
1.安装CocoaPods
sudo gem install cocoapods
2.设置pod仓库
pod setup
3.测试
pod --version
4.卸载CocoaPods
sudo gem uninstall cocoapods
二.注意:
1.如果gem太老可能会有问题,所以安装之前最好升级一下gem
sudo gem update --system
2.ruby的软件源rubygems.org使用的亚马逊的云服务被墙了,所以需要更新一
下ruby的源,如下代码将官方的ruby源替换成国内淘宝的源
gem sources --removehttps://rubygems.org/gem sources -ahttp://ruby.taobao.org/
gem sources -l
3.pod setup在执行时,会输出Setting up CocoaPods master repo,但是会等待比较久的时间。这步其实是Cocoapods在将它的信息下载到~/.cocoapods目录下,如果你等太久,可以试着cd到那个目录,用du -sh *来查看下载进度。你也可以参考本文接下来的使用cocoapods的镜像索引一节的内容来提高下载速度。
4.使用CocoaPods的镜像索引所有的项目的Podspec文件都托管在https://github.com/CocoaPods/Specs。
第一次执行pod setup时,CocoaPods会将这些podspec索引文件更新到本地的~/.cocoapods/目录下,这个索引文件比较大,有100M左右。所以第一次更新时非常慢。
为了提高下载速度, 可以将文件托管地址从github替换为国内oschina,这样会快很多。如下操作就可以将github替换为国内oschina
pod repo remove master
pod repo add masterhttp://git.oschina.net/akuandev/Specs.git
pod repo update
三、CocoaPods使用:
使用时需要新建一个名为Podfile的文件
- 1.利用vim创建Podfile。 注意:Podfile文件应该和你的工程文件.xcodeproj在同一个目录下
vim Podfile
- 2.将依赖的库名字依次列在文件中
platform :ios
pod 'JSONKit', '~> 1.4'
pod'Reachability', '~>3.0.0'
pod'AFNetworking', '3.0.0'
pod 'RegexKitLite'
- 3.保存并退出
esc :wq(按下esc,然后输入:wq)
platform :ios
pod 'JSONKit', '~> 1.4'
pod'Reachability', '~>3.0.0'
pod'AFNetworking', '3.0.0'
- 3.1podfile文件第三方框架中符号的含义
pod 'AFNetworking' //不显式指定依赖库版本,表示每次都获取最新版本
pod 'AFNetworking', '2.0' //只使用2.0版本
pod 'AFNetworking', '>2.0' //使用高于2.0的版本
pod 'AFNetworking', '>=2.0' //使用大于或等于2.0的版本
pod 'AFNetworking', '<2.0' //使用小于2.0的版本
pod 'AFNetworking', '<=2.0' //使用小于或等于2.0的版本
pod 'AFNetworking', '~>0.1.2' //使用大于等于0.1.2但小于0.2的版本,相当于>=0.1.2并且<0.2.0
pod 'AFNetworking', '~>0.1' //使用大于等于0.1但小于1.0的版本
pod 'AFNetworking', '~>0' //高于0的版本,写这个限制和什么都不写是一个效果,都表示使用最新版本
- 4.利用CocoPods下载类库
pod install
注意:
- 1.利用CocoPods管理类库后,以后打开项目就用xxxx.xcworkspace打开,而不是之前的.xcodeproj文件
- 2.每次更改了Podfile文件,你需要重新执行一次pod update命令。
- 3.关于.gitignore
当你执行pod install之后,除了Podfile外,CocoaPods还会生成一个名为Podfile.lock的文件,你不应该把这个文件加入到.gitignore中。因为Podfile.lock会锁定当前各依赖库的版本,之后如果多次执行pod install不会更改版本,要pod update才会改Podfile.lock了。这样多人协作的时候,可以防止第三方库升级时造成大家各自的第三方库版本不一致。 - 4.CocoaPods在执行pod install和pod update时,会默认先更新一次CocoPods的spec仓库索引。使用--no-repo-update参数可以禁止其做索引更新操作
pod install --no-repo-update
pod update --no-repo-update
四、在Xcode中的使用(插件)
不经常使用终端的可以使用cocoapods-xcode-plugin
这款插件,它安装完成之后是这个效果
(具体使用方法请参考README文档,以下是GitHub下载地址)
https://github.com/kattrali/cocoapods-xcode-plugin
补充
- 1.在系统版本更新到10.11.4之后在xcode中使用这款插件需要在插件中手动设置gem_path才能继续正常使用,正确路径如下:
- 2.在多人团队开发中,建议直接使用精确版本号,不要把podfiel.lock文件添加到.gitignore文件中去.
五、关于CocoaPods的一些参考文献:
1.用CocoaPods做iOS程序的依赖管理:
http://www.devtang.com/blog/2014/05/25/use-cocoapod-to-manage-ios-lib- dependency/2.CocoaPods最佳实践:
http://weibo.com/p/10016038008754904927543.极速化CocoaPods:
http://www.cocoachina.com/ios/20150123/11002.html4.深入理解CocoaPods:
http://objccn.io/issue-6-4/