cocospod 安装和使用
一 ruby 安装
要安装coocspod 首先需要安装ruby,可以先安装xcode,在安装macport 下载地址,最后执行命令 port install
ruby
二、安装CocoaPods
1、安装
CocoaPods是用Ruby实现的,要想使用它首先需要有Ruby的环境。幸运的是OS X系统默认的已经可以运行Ruby了,因此我们只需要执行以下命令:
- $ sudo gem install cocoapods
CocoaPods是以Ruby gem包的形式被安装的。在安装执行的过程中,可能会问我们是不是更新rake,输入y即可。这是因为rake gem包会在安装的过程中检查更细,如果有可用的新版本就会出现刚才的选项。
在安装进程结束的时候,执行命令:
- $ pod setup
如果没有报错,就说明一切安装就成功了!
2、安装过程中可能遇到的问题
①执行完install命令半天没反应
这有可能是因为Ruby的默认源使用的是cocoapods.org,国内访问这个网址有时候会有问题,网上的一种解决方案是将远替换成淘宝的,替换方式如下:
- $ gem sources --remove https://rubygems.org/
- //等有反应之后再敲入以下命令
- $ gem sources -a http://ruby.taobao.org/
要想验证是否替换成功了,可以执行:
- $ gem sources -l
正常的输出是:
- *** CURRENT SOURCES ***
- http://ruby.taobao.org/
②gem版本过老
gem是管理Ruby库和程序的标准包,如果它的版本过低也可能导致安装失败,解决方案自然是升级gem,执行下述命令即可:
- $ sudo gem update --system
③安装完成后,执行pod
setup命令时报错:
- /Users/wangzz/.rvm/rubies/ruby-1.9.3-p448/lib/ruby/site_ruby/1.9.1/rubygems/dependency.rb:298:in `to_specs': Could not find 'cocoapods' (>= 0) among 6 total gem(s) (Gem::LoadError)
- from /Users/wangzz/.rvm/rubies/ruby-1.9.3-p448/lib/ruby/site_ruby/1.9.1/rubygems/dependency.rb:309:in `to_spec'
- from /Users/wangzz/.rvm/rubies/ruby-1.9.3-p448/lib/ruby/site_ruby/1.9.1/rubygems/core_ext/kernel_gem.rb:53:in `gem'
- from /Users/wangzz/.rvm/rubies/ruby-1.9.3-p448/bin/pod:22:in `<main>'
这就是路径设置的问题,可以通过执行:
- $ rvm use ruby-1.9.3-p448
解决该问题。
3、升级CocoaPods
升级很简单,再次执行安装命令即可:
- $ sudo gem install cocoapods
需要注意的是,如果安装的时候使用了sudo,升级的时候一样需要使用该关键字,不然升级完了以后又会出现路径不匹配问题。
三、使用CocoaPods
如果之前做的一切顺利,接下来就可以体验体验CocoaPods的神奇之处了,需要经过以下几步:
为了演示这个过程,我创建了一个名为CocoaPodsTest的工程。
1、创建Podfile
CocoaPods的一切都是从一个名为Podfile的文件开始的,我们需要先创建这个文件。个人习惯使用命令行,我会这样做:
- $ cd /Users/wangzz/Desktop/CocoaPodsTest
- $ touch Podfile
首先进入到工程的根目录下,创建空白的Podfile文件,创建完毕的目录结构如下图:
PS:Podfile文件也可以不放在工程的根目录下,只是会稍微麻烦点,在下一篇文章中会有介绍,敬请关注。)
2、编辑Podfile
根据需要,我们可以在Podfile文件中写入需要用到的第三方库,以SBJson、AFNetworking、Reachability三个库为例,我的Podfile内容如下:
- platform :ios
- pod 'Reachability', '~> 3.0.0'
- pod 'SBJson', '~> 4.0.0'
- platform :ios, '7.0'
- pod 'AFNetworking', '~> 2.0'
3、执行导入命令
准备工作都完成后,开始导入第三方库:
- $ cd /Users/wangzz/Desktop/CocoaPodsTest
- $ pod install
首先进入工程根目录,然后执行pod install命令,CocoaPods就开始为我们做下载源码、配置依赖关系、引入需要的framework等一些列工作,命令的执行结果打印出来如下:
- Analyzing dependencies
- Downloading dependencies
- Installing AFNetworking (2.1.0)
- Installing JSONKit (1.5pre)
- Installing Reachability (3.0.0)
- Generating Pods project
- Integrating client project
- [!] From now on use `CocoaPodsTest.xcworkspace`.
这就说明pod install命令执行成功了。再来看看工程根目录发生的变化,如下图:
可以看到,工程的根目录下多了三个东西:CocoaPodsTest.xcworkspace、Podfile.lock文件和Pods目录。
(PS:篇幅有限,Podfile.lock文件会放到系列文章的下一篇介绍,敬请关注。)
再看看刚才执行完pod install命令打印出来的内容的最后一行:
- [!] From now on use `CocoaPodsTest.xcworkspace`.
提示我们从现在起,我们需要使用CocoaPodsTest.xcworkspace文件来开发。
对于工程发生的变化,有几点需要说明:
- 第三方库会被编译成静态库供我们正真的工程使用
CocoaPods会将所有的第三方库以target的方式组成一个名为Pods的工程,该工程就放在刚才新生成的Pods目录下。整个第三方库工程会生成一个名称为libPods.a的静态库提供给我们自己的CocoaPodsTest工程使用。
- 我们的工程和第三方库所在的工程会由一个新生成的workspace管理
为了方便我们直观的管理工程和第三方库,CocoaPodsTest工程和Pods工程会被以workspace的形式组织和管理,也就是我们刚才看到的CocoaPodsTest.xcworkspace文件。
原来的工程设置已经被更改了,这时候我们直接打开原来的工程文件去编译就会报错,只能使用新生成的workspace来进行项目管理。
打开CocoaPodsTest.xcworkspace,界面如下:
四、Podfile.lock文件
- PODS:
- - AFNetworking (2.1.0):
- - AFNetworking/NSURLConnection
- - AFNetworking/NSURLSession
- - AFNetworking/Reachability
- - AFNetworking/Security
- - AFNetworking/Serialization
- - AFNetworking/UIKit
- - AFNetworking/NSURLConnection (2.1.0):
- - AFNetworking/Reachability
- - AFNetworking/Security
- - AFNetworking/Serialization
- - AFNetworking/NSURLSession (2.1.0):
- - AFNetworking/NSURLConnection
- - AFNetworking/Reachability (2.1.0)
- - AFNetworking/Security (2.1.0)
- - AFNetworking/Serialization (2.1.0)
- - AFNetworking/UIKit (2.1.0):
- - AFNetworking/NSURLConnection
- - Reachability (3.0.0)
- - SBJson (4.0.0)
- DEPENDENCIES:
- - AFNetworking (~> 2.0)
- - Reachability (~> 3.0.0)
- - SBJson (~> 4.0.0)
- SPEC CHECKSUMS:
- AFNetworking: c7d7901a83f631414c7eda1737261f696101a5cd
- Reachability: 500bd76bf6cd8ff2c6fb715fc5f44ef6e4c024f2
- SBJson: f3c686806e8e36ab89e020189ac582ba26ec4220
- COCOAPODS: 0.29.0
Podfile.lock文件最大得用处在于多人开发。对于没有在Podfile中指定Pods依赖库版本的写法,如下:
- pod 'SBJson'
该句话用于获取当前SBJson这个Pods依赖库的最新版本。
当团队中的某个人执行完pod install命令后,生成的Podfile.lock文件就记录下了当时最新Pods依赖库的版本,这时团队中的其它人check下来这份包含Podfile.lock文件的工程以后,再去执行pod install命令时,获取下来的Pods依赖库的版本就和最开始用户获取到的版本一致。如果没有Podfile.lock文件,后续所有用户执行pod install命令都会获取最新版本的SBJson,这就有可能造成同一个团队使用的依赖库版本不一致,这对团队协作来说绝对是个灾难!
- 更改Podfile,使其指向最新版本的SBJson依赖库;
- 执行pod update命令;
五、Podfile文件
1、Podfile文件存放位置
这是在上篇文章中,遗留的一个问题。通常情况下我们都推荐Podfile文件都放在工程根目录,如下图所示:
- xcodeproj "/Users/wangzz/Desktop/CocoaPodsTest/CocoaPodsTest.xcodeproj"
- platform :ios
- pod 'Reachability', '~> 3.0.0'
- pod 'SBJson', '~> 4.0.0'
- platform :ios, '7.0'
- pod 'AFNetworking', '~> 2.0'
指定路径使用的是xcodeproj关键字。
2、Podfile和target
- link_with 'CocoaPodsTest', 'Second'
- platform :ios
- pod 'Reachability', '~> 3.0.0'
- pod 'SBJson', '~> 4.0.0'
- platform :ios, '7.0'
- pod 'AFNetworking', '~> 2.0'
这种写法就实现了CocoaPodsTest和Second两个target共用相同的Pods依赖库。
- target :'CocoaPodsTest' do
- platform :ios
- pod 'Reachability', '~> 3.0.0'
- pod 'SBJson', '~> 4.0.0'
- platform :ios, '7.0'
- pod 'AFNetworking', '~> 2.0'
- end
- target :'Second' do
- pod 'OpenUDID', '~> 1.0.0'
- end
3、使用Podfile管理Pods依赖库版本
- 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的版本
- pod 'AFNetworking', '~>0.1' //使用大于等于0.1但小于1.0的版本
- pod 'AFNetworking', '~>0' //高于0的版本,写这个限制和什么都不写是一个效果,都表示使用最新版本
六、CocoaPods常用命令
1、pod
install
2、pod
update
3、pod
search
- $ pod search OpenUDID
后面的OpenUDID为参数。
- -> OpenUDID (1.0.0)
- Open source initiative for a universal and persistent UDID solution for iOS.
- pod 'OpenUDID', '~> 1.0.0'
- - Homepage: http://OpenUDID.org
- - Source: https://github.com/ylechelle/OpenUDID.git
- - Versions: 1.0.0 [master repo]
这里我们搜到了一条可用数据,里面描述了OpenUDID库的简要信息。其实我们真正需要的是上述结果中的第三行:
- pod 'OpenUDID', '~> 1.0.0'
不难看出,这是我们需要添加到Podfile文件中的。
4、pod setup
- $ pod setup
- Setting up CocoaPods master repo
- Updating 7cd4668..f3d3ced
- Fast-forward
接下来还会打印很多更新信息。
这条命令用于跟新本地电脑上的保存的Pods依赖库tree。由于每天有很多人会创建或者更新Pods依赖库,这条命令执行的时候会相当慢,还请耐心等待。我们需要经常执行这条命令,否则有新的Pods依赖库的时候执行pod search命令是搜不出来的。
七、创建自己的github仓库
二、clone仓库到本地
- $ git clone https://github.com/wangzz/WZMarqueeView.git
八、向本地git仓库中添加创建Pods依赖库所需文件
1、后缀为.podspec文件
1.1 podspec文件内容
- Pod::Spec.new do |s|
- s.name = "WZMarqueeView"
- s.version = "1.0.0"
- s.summary = "A marquee view used on iOS."
- s.description = <<-DESC
- It is a marquee view used on iOS, which implement by Objective-C.
- DESC
- s.homepage = "https://github.com/wangzz/WZMarqueeView"
- # s.screenshots = "www.example.com/screenshots_1", "www.example.com/screenshots_2"
- s.license = 'MIT'
- s.author = { "王中周" => "wzzvictory_tjsd@163.com" }
- s.source = { :git => "https://github.com/wangzz/WZMarqueeView.git", :tag => s.version.to_s }
- # s.social_media_url = 'https://twitter.com/NAME'
- s.platform = :ios, '4.3'
- # s.ios.deployment_target = '5.0'
- # s.osx.deployment_target = '10.7'
- s.requires_arc = true
- s.source_files = 'WZMarqueeView/*'
- # s.resources = 'Assets'
- # s.ios.exclude_files = 'Classes/osx'
- # s.osx.exclude_files = 'Classes/ios'
- # s.public_header_files = 'Classes/**/*.h'
- s.frameworks = 'Foundation', 'CoreGraphics', 'UIKit'
- end
该文件是ruby文件,里面的条目都很容易知道含义。
1.2 如何创建podspec文件
- $ pod spec create WZMarqueeView
也会创建名为WZMarqueeView.podspec的文件。但是打开创建完的文件你就会发现里面的东西太多了,很多都是我们不需要的。
2、LICENSE文件
3、主类文件
4、demo工程
5、README.md
九、提交修改文件到github
1、pod验证
- $ set the new version to 1.0.0
- $ set the new tag to 1.0.0
这两条命令是为pod添加版本号并打上tag。然后执行pod验证命令:
- $ pod lib lint
如果一切正常,这条命令执行完后会出现下面的输出:
- -> WZMarqueeView (1.0.0)
- ZMarqueeView passed validation.
到此,pod验证就结束了。
2、本地git仓库修改内容上传到github仓库
- $ git add -A && git commit -m "Release 1.0.0."
- $ git tag '1.0.0'
- $ git push --tags
- $ git push origin master
上述命令均属git的范畴,这里不多述。如果一切正常,github上就应该能看到自己刚添加的内容了。如下图所示:
十、上传podspec文件到CocoaPods官方仓库中
1、fork一份CocoaPods官方的Specs仓库
2、将fork的仓库clone到本地
- $ git clone https://github.com/wangzz/Specs.git
注意,大家需要将对应的仓库地址换成自己的。
3、将自己的podspec文件添加到本地Specs仓库中
4、上传本地Specs仓库中的修改到github仓库
- $ git add -A && git commit -m "Add WZMarqueeView podspec file"
- $ git push origin master
成功以后就能在github上自己fork的Specs仓库中看到刚上传的文件了。
5、将在自己fork的Specs上做的修改pull给CocoaPods官方的Specs仓库
6、查看审核进度
十一、查看我们自己创建的Pods依赖库
- $ pod setup
在我的CocoaPods系列教程中的第一篇:CocoaPods详解之----进阶篇中的最后部分介绍过这条命令,它会将所有的Pods依赖库tree跟新到本地。执行完这条命令,再去执行:
- $ pod search WZMarqueeView
就能显示出对应的介绍信息了!
cocospod 安装和使用的更多相关文章
- cocospod 安装和使用 podfile 问题解决
Podfile 不识别 usr_framework!,系本地Pods版本太低,要在0.36以上. 以下转自:http://blog.csdn.net/eqera/article/details/393 ...
- 总结下cocopods的安装
一:CocoaPods是什么? 当你开发iOS应用时,会经常使用到很多第三方开源类库,比如JSONKit,AFNetWorking等等.可能某个类库又用到其他类库,所以要使用它,必须得另外下载其他类库 ...
- docker——容器安装tomcat
写在前面: 继续docker的学习,学习了docker的基本常用命令之后,我在docker上安装jdk,tomcat两个基本的java web工具,这里对操作流程记录一下. 软件准备: 1.jdk-7 ...
- 网络原因导致 npm 软件包 node-sass / gulp-sass 安装失败的处理办法
如果你正在构建一个基于 gulp 的前端自动化开发环境,那么极有可能会用到 gulp-sass ,由于网络原因你可能会安装失败,因为安装过程中部分细节会到亚马逊云服务器上获取文件.本文主要讨论在不变更 ...
- Sublime Text3安装JsHint
介绍 Sublime Text3使用jshint依赖Nodejs,SublimeLinter和Sublimelinter-jshint. NodeJs的安装省略. 安装SublimeLinter Su ...
- Fabio 安装和简单使用
Fabio(Go 语言):https://github.com/eBay/fabio Fabio 是一个快速.现代.zero-conf 负载均衡 HTTP(S) 路由器,用于部署 Consul 管理的 ...
- gentoo 安装
加载完光驱后 1进行ping命令查看网络是否通畅 2设置硬盘的标识为GPT(主要用于64位且启动模式为UEFI,还有一个是MBR,主要用于32位且启动模式为bois) parted -a optima ...
- Linux平台 Oracle 10gR2(10.2.0.5)RAC安装 Part3:db安装和升级
Linux平台 Oracle 10gR2(10.2.0.5)RAC安装 Part3:db安装和升级 环境:OEL 5.7 + Oracle 10.2.0.5 RAC 5.安装Database软件 5. ...
- Linux平台 Oracle 10gR2(10.2.0.5)RAC安装 Part1:准备工作
Linux平台 Oracle 10gR2(10.2.0.5)RAC安装 Part1:准备工作 环境:OEL 5.7 + Oracle 10.2.0.5 RAC 1.实施前准备工作 1.1 服务器安装操 ...
随机推荐
- Java基础——数组Array
一.数组基本概念 数组是相同类型数据的有序集合. 数组描述的是相同类型的若干个数据,按照一定的先后次序排列组合而成.其中,每一个数据称作一个数组元素,每个数组元素可以通过一个下标来访问它们. 数组有三 ...
- jsp导出Excel功能的实现
借助POI的excel接口,可以方便得实现excel导出功能: 首先需要引入poi对应的jar包 1.前端jsp页面需要一个a链接. web页面文件MIM类型的下载,只需要一个a元素,该a可以链到该文 ...
- VS中查看/修改Dialog控件TAB顺序的方法
打开资源视图,打开Dialog的编辑界面 查看: 格式>Tab键顺序 修改: 格式>Tab键顺序 用鼠标左键按你想要的顺序点击各个控件的TAB标签,就设定了 那些你想要TAB键能选择到的控 ...
- iOS 对UIButton的imageView和titleLabel进行重新布局
#import <UIKit/UIKit.h> @interface AppDelegate : UIResponder <UIApplicationDelegate> @pr ...
- 使用 jQuery Deferred 和 Promise 创建响应式应用程序
这篇文章,我们一起探索一下 JavaScript 中的 Deferred 和 Promise 的概念,它们是 JavaScript 工具包(如Dojo和MochiKit)中非常重要的一个功能,最近也首 ...
- 生成arff文件,csv转为arff
一.什么是arff格式文件 1.arff是Attribute-Relation File Format缩写,从英文字面也能大概看出什么意思.它是weka数据挖掘开源程序使用的一种文件模式.由于weka ...
- Excel公式无法重算,暂无法解决
一份复杂的excel报表,某些单元格是用求和公式算出来的值,但生成之后,用excel打开,无法显示公式结果,按F9也没有用,只能在单元格公式双击后回车才会显示.而在WPS2010按F9就可以重算,WP ...
- PHYLIP linux安装
PHYLIP的安装: http://download.chinaunix.net/download.php?id=29483&ResourceID=8135下载 gunzip phylip-3 ...
- DIY小能手|别买电动滑板车了,咱做一台吧
!! http://www.shoudian.org/thread-316111-1-1.html http://www.jiequer.com/html/news/xinpin/2014/1218/ ...
- t4 multiple output sample
<#@ output extension=".js" #> <#@ template debug="false" hostspecific=& ...