背景(废话可略过)
进入“网易暴雪合作部”之后主要负责《随身集合石》iOSAPP的开发,也会参与其他《随身xxx》的开发和维护,发现许多通用模块(比如:IM,login)的代码都是各个工程分别导入引用。这样维护起来就特别麻烦,比如登录模块做了修改,那么各个工程都得重新导入或者修改,容易出错,也浪费时间。正好各个工程都是用的CocoaPods来管理的三方资源,所以打算将通用模块也加入CocoaPods的管理。公司代码都是利用SVN来进行管理,下面就如何利用SVN管理svn私有文件做一下介绍。
一、安装CocoaPods
*在安装CocoaPods之前,首先要在本地安装好Ruby环境(附1)
通过Terminal安装CocoaPods
sudo gem install cocoapods
可能需要输入开机密码
由于国内经常会被‘墙’,可能需要修改一下镜像地址:
gem sources --remove https://rubygems.org/
OS10.10之前系统
gem sources -a http://ruby.taobao.org/
OS10.10以及之后
gem sources -a https://ruby.taobao.org/
之后我们需要检查一下修改结果
gem sources -l
结果如下图说明修改成功
然后通过
sudo gem install cocoapods
再次安装CocoaPods。
完成之后
pod --version
检查cocoapods版本。
执行命令
pod setup
开始安装。
安装时间取决于网速,可以另打开个Terminal窗口,
cd ~/.cocoapods
进入到cocoapods文件夹,然后输入命令
du -sh
来查询安装进度,隔段时间查询一次。
二、pod管理通用三房库
1.创建Podfile
打开Terminal 进入到工程文件(xxx. xcodeproj)所在文件夹,
pod init
可以发现在文件夹中创建成功Podfile文件,xcode打开如下图所示
2.编辑Podfile
1.用Xcode打开podfile文件(不要使用text编译器打开);
2.取消# platform :ios, ‘9.0’的注释,并编辑对应的iOS工程最低版本;
3.通过命令
pod search xxxx
搜索可用的三房库的版本,并将对应的pod语句添加进对应target。
以AFNetworking为例如下图:
3.添加pods
1.打开terminal 通过命令进入到podfile所在文件夹,执行命令
pod install
来安装pod三房库。如果不需要更新repo可通过命令
pod install —verbose —no-repo-update
来快速安装三房库。
2.添加完成,关闭工程,重新打开文件夹中xxx.workspace文件即可。
3.使用三房库要用"<>"
#import <AFNetworking/AFNetworking.h>
三、pod管理私有类库
1.初始化podspec文件
1.打开terminal,命令进入到本地私有类库所在文件夹,通过命令
pod spec create XXX
来创建XXX.podspec文件。
2.通过XCode打开XXX.podspec文件,根据注释,修改对应参数。
或者直接全删,复制下面一段再对应修改。
Pod::Spec.new do |s|
s.name = 'PodProjSpec'
s.version = '0.0.1'
s.license = 'MIT'
s.summary = ‘PodProjSpec summary.'
s.homepage = 'https://github.com/appdesignvault'
s.author = { 'authorname' => 'contact' }
s.source = { :git => 'https://github.com/appdesignvault/PodProjSpec.git', :commit => 'f17b15c15574d6d101cd5fcfd58239e16e806647' }
s.platform = :ios
s.source_files = 'PodProjSpec/Classes/*.{h,m}'
s.resources = "PodProjSpec/Resources/*.png"
s.framework = 'UIKit'
s.requires_arc = true
end
3.验证
pod lib lint
无报错则成功,如果有warning或者报错,可根据提示修改。
4.修改完成之后将通用类库的文件上传svn,然后在需要引用该类库的工程的Podfile对应的target下面添加
pod 'PodProjSpec', :svn => “https://xxx.xxx.xxx.xxx/svn/mobiledev/ios/XXX/"
这个是你的私有类库xxx.podspec在SVN上对应的地址。
2.关于私有类库地址
1.本地
s.source = { :git => '~/Desktop/PodProj' }
对应podfile
pod 'PodProj', :local => '~/Desktop/PodProj'
2.svn
s.source = { :svn => “XXX/svn/mobiledev/ios/PodProj/PodProj/" ,:tag=>s.version}
对应podfile
pod 'PodProj', :svn => “XXX/svn/mobiledev/ios/PodProj/PodProj/"
3.git
s.source = { :git => 'https://github.com/XXX/PodProj.git', :tag=>s.version }
对应podfile
source 'https://github.com/XXX/PodProj.git' pod ‘PodProj','~>0.8.1'
下图是我demo中的对应,可参考:
附
1.ruby安装
步骤1 - 安装 RVM
RVM 是干什么的这里就不解释了,后面你将会慢慢搞明白。
curl -L https://get.rvm.io | bash -s stable
期间可能会问你sudo管理员密码,以及自动通过homebrew安装依赖包,等待一段时间后就可以成功安装好 RVM。
然后,载入 RVM 环境(新开 Termal 就不用这么做了,会自动重新载入的)
source ~/.rvm/scripts/rvm
检查一下是否安装正确
rvm -v
rvm 1.22.17 (stable) by Wayne E. Seguin wayneeseguin@gmail.com, Michal Papis mpapis@gmail.com [https://rvm.io/]
步骤2 - 用 RVM 安装 Ruby 环境
列出已知的ruby版本
rvm list known
可以选择现有的rvm版本来进行安装(下面以rvm 2.0.0版本的安装为例)
rvm install 2.0.0
同样继续等待漫长的下载,编译过程,完成以后,Ruby, Ruby Gems 就安装好了。
另附:
查询已经安装的ruby
rvm list
卸载一个已安装版本
rvm remove 1.9.2
步骤3 - 设置 Ruby 版本
RVM 装好以后,需要执行下面的命令将指定版本的 Ruby 设置为系统默认版本
rvm 2.0.0 --default
同样,也可以用其他版本号,前提是你有用 rvm install 安装过那个版本
这个时候你可以测试是否正确
ruby -v
ruby 2.0.0p247 (2013-06-27 revision 41674) [x86_64-darwin13.0.0]
gem -v
2.1.6
这有可能是因为Ruby的默认源使用的是cocoapods.org,国内访问这个网址有时候会有问题,网上的一种解决方案是将远替换成淘宝的,替换方式如下:
gem source -r https://rubygems.org/
gem source -a https://ruby.taobao.org
要想验证是否替换成功了,可以执行:
gem sources -l
正常的输出结果:
CURRENT SOURCES
http://ruby.taobao.org/
到这里就已经把Ruby环境成功的安装到了Mac OS X上,接下来就可以进行相应的开发使用了。