基于 svn 服务器及 cocoapods-repo-svn 插件进行组件化私有库的创建
一、准备
- 组件化
- 随着业务需求的增长,在单工程 MVC 模式下,app 代码逐渐变得庞大,面对的高耦合的代码和复杂的功能模块,我们或许就需要进行重构了,以组件化的形式,将需要的组件以 pod 私有库的形式安装到最后的主工程中,组件间各自独立、解耦,仅依赖中间件进行通信,这或许就是极好的架构形式。
- 使用 CocoaPods
- 如果你的 Mac 系统升级过了,避免出现莫名的问题,强烈建议重装 CocoaPods 及更新 ruby。(可参考 http://www.jianshu.com/p/8169f5d7f364)
- CocoaPods 下载框架的原理及 spec、Podfile 文件,可参考 http://www.jianshu.com/p/8a7b9232cbab 或 http://blog.csdn.net/morenyaojing/article/details/53376475 。
- CocoaPods 默认的 spec repo,是基于 git 的,可创建基于 git 管理的私有库 spec repo,因公司性质及要求,代码一律使用内部 svn 管理。因此本文完全使用 svn,来进行私有库制作。(使用 git 的文章网上很多,更方便,其实最终感觉也都差不多)
- 安装 cocoapods-repo-svn 插件,参考 https://github.com/dustywusty/cocoapods-repo-svn 。
- 代码文件来源
- 因公司项目原因,本文以网上的 demo 代码来演示。demo 来源 https://github.com/sun6boys/CRMainProject
二、制作基于 svn 的私有 sepc repo
- 使用 svn 管理,先在 svn 服务器上新建一个放 spec 的远程仓库,本文以 SpecRepo 命名,该仓库不需要创建标准的 trunk、tags、branches 目录,仅仅是放组件的 spec 文件的。
- 使用该 SpecRepo svn 地址建立私有 repo,命令行操作如下
pod repo-svn add SpecRepo http://10.211.55.3/svn/SpecRepo
这里是 svn 管理的,利用的是 cocoapods-repo-svn 插件,如果是 git 管理的,那就是默认的
pod repo add xxx git地址
建立了私有 SpecRepo,其本地
.cocoapods/repos
文件夹目录如下
使用
pod repo
命令查看 repo 如下
三、基本的组件化的创建
- 建立 CRProtocolManager 的组件私有库
使用 svn 管理,先在 svn 服务器上新建一个 CRProtocolManager 的仓库,因为是代码文件且需要使用 tag,所以使用标准的 trunk、tags、branches 目录
使用
pod lib create CRProtocolManager
命令来下载带有默认模板的库,之后基于默认模板进行修改- 使用该命令后最回答几个问题,分别是姓名、邮箱(用于 spec 文件中的作者信息)、选择语言(有 Swift 和 ObjC,这里选择 ObjC)、是否需要 demo 工程(这个是需要的,利用这个 demo 进行组件测试)、选择测试库(这里选 None)、do view based testing(这里选 No)
在 Finder 中,将 CRProtocolManager 的核心文件复制到 demo 工程中的 CRProtocolManager 下 Classes 文件夹下,并删除模板文件 ReplaceMe.m
- 其中 Assets 文件夹下放与该组件有关的图片等资源文件
- 其中 Assets 文件夹下放与该组件有关的图片等资源文件
命令行中 cd Example 工程目录下,
pod install
来更新工程的 CRProtocolManager 核心代码- 该工程目录下 Podfile 文件中
pod 'CRProtocolManager', :path => '../'
,指向的外层文件夹下的 CRProtocolManager.podspec 文件,因此可以这样添加删除文件后使用pod install
来更新核心代码到工程里
- 该工程目录下 Podfile 文件中
添加完核心代码后,更改 CRProtocolManager.podspec 文件
- 一个是 s.version 这个和 svn 要打 tag 的编号是一致,例如
s.version = '1.0'
- 一个是
s.source = {:svn =>'http://10.211.55.3/svn/CRProtocolManager', :tag => s.version.to_s }
,原来 s.source 是 git 地址,这里改为 svn 地址,指向 svn 代码仓库。 - s.source_files、s.license、s.name(名字和svn仓库名、创建的组件名最好统一)可保持不变
- s.summary、s.description、s.homepage、s.author 这些描述性的信息按需修改
- s.ios.deployment_target = '8.0' 按需修改
# 示例
Pod::Spec.new do |s|
s.name = 'CRProtocolManager'
s.version = '1.0'
s.summary = 'CRProtocolManager.'
s.description = <<-DESC
CRProtocolManager xxxx
DESC
s.homepage = 'http://www.baidu.com'
s.license = { :type => 'MIT', :file => 'LICENSE' }
s.author = { 'HOWIE-CH' => 'zh200742zh@126.com' }
s.source = {:svn =>'http://10.211.55.3/svn/CRProtocolManager', :tag => s.version.to_s }
s.ios.deployment_target = '8.0'
s.source_files = 'CRProtocolManager/Classes/**/*'
# s.resource_bundles = {
# 'CRProtocolManager' => ['CRProtocolManager/Assets/*.png']
# }
# s.frameworks = 'UIKit', 'MapKit'
# s.dependency 'AFNetworking', '~> 2.3'
end
- 一个是 s.version 这个和 svn 要打 tag 的编号是一致,例如
将更改好的、测试好的组件提交到 svn CRProtocolManager 仓库 trunk 下,注意:因为模板是从 github.com 上 clone 的,所以这里先把 .git 文件夹删掉。(本文使用的是 smartSVN 管理工具)
对代码进行打 tag,且编号为 1.0,与 spec 文件里的 s.version 一致。
将 CRProtocolManager.podspec 文件提交到之前制作好的私有 sepc repo 中
cd 到 CRProtocolManager.podspec 所在目录,使用
pod repo-svn push SpecRepo CRProtocolManager.podspec
- 此时 svn 仓库和 .cocoapods/repo/SpecRepo 下都有 CRProtocolManager.podspec
- 此时 svn 仓库和 .cocoapods/repo/SpecRepo 下都有 CRProtocolManager.podspec
可在此之前进行 spec 文件有效性检查,
pod repo-svn lint CRProtocolManager.podspec
- 使用 CRProtocolManager 的私有库组件
- xcode 新建一个工程,使用
pod init
创建 Podfile 文件 - Podfile 中默认是搜索 .cocoapods/repo/master 对应的官方默认公用库的源,因此需要 Podfile 中添加本地 repo 源的地址
platform :ios, '8.0'
target 'test' do
plugin 'cocoapods-repo-svn', :sources => [
'http://10.211.55.3/svn/SpecRepo' # 添加 svn 服务器中私有库 spec 的 repo
]
use_frameworks!
pod 'CRProtocolManager' # 本地 svn 私有库
pod 'AFNetworking' # 可直接 pod 公开第三方库
end
- git 的话要同时标明私有 repo 地址和默认 repo 地址(以 source 'git地址' 形式)
- 直接使用
pod install
即可安装 CRProtocolManager 私有组件 - 会出现的问题
pod install
报错找不到组件,可使用pod repo remove SpecRepo
后重新添加pod repo-svn add SpecRepo http://10.211.55.3/svn/SpecRepo
,然后pod repo-svn update SpecRepo
,若还没解决可能是 ruby、CocoaPods 版本不是最新的原因,建议重装后操作。- CRProtocolManager.podspec 文件提交到私有 sepc repo中后,
pod search CRProtocolManager
搜索不到,可到/Users/HOWIE-CH/Library/Caches/CocoaPods
下删除 search_index.json 文件后重试。
- xcode 新建一个工程,使用
四、私有库和私有库之间的依赖、私有库依赖共有库及 subspec 的应用
其他组件和第三步一样进行操作,最后 svn 服务器截图和 SpecRepo 文件夹截图如下
依赖关系,例如对 CRGoodsDetail 进行探索 svn 的制作私有库之间的依赖的解决
- CRGoodsDetail 中 CRGoodsDetailServiceProvide 依赖 CRGoodsDetailServiceProtocol 和 CRProtocolManager,CRGoodsDetailViewController 依赖 CRConfirmOrderServiceProtocol 和 CRProtocolManager。
- pod lib create 创建好工程,进行核心的代码的拷贝和工程的更新操作之后,直接编译会报错的,因为存在依赖关系
- 在 CRGoodsDetail.podspec 文件中添加
# 需要的依赖私有库
s.dependency 'CRProtocolManager'
s.dependency 'CRConfirmOrderServiceProtocol'
s.dependency 'CRGoodsDetailServiceProtocol'
# 依赖公有库 ,可添加依赖的公有库
s.dependency 'SDWebImage'
- 在工程目录下的 Podfile 文件下添加私有 repo 的 svn 地址,才能下载私有库
use_frameworks!
target 'CRGoodsDetail_Example' do
# 添加私有 repo 的 svn 地址
plugin 'cocoapods-repo-svn', :sources => [
'http://10.211.55.3/svn/SpecRepo'
]
pod 'CRGoodsDetail', :path => '../'
target 'CRGoodsDetail_Tests' do
inherit! :search_paths
end
end
- pod install 就会装好依赖库,包括依赖的私有库和公有库
- 若出现问题则参考标题三中的解决方案
- 该 demo 工程 Podfile 文件的 pod 'CRGoodsDetail' 指向上一个目录的 CRGoodsDetail.podspec 文件,因此会检测 s.dependency 依赖的库,依赖的私有库是在从 Podfile 中添加的私有 repo 的 svn 地址中去找的
- 该 demo 工程运行测试后没有报错后,要提交 svn,打(新) tag(组件的迭代开发维护),提交 spec 文件到私有 repo 中
subspec 的使用
例如 CRGoodsDetail 中可分为模块文件(MVC 文件)及 Provider 文件,因此可使用 subspec
CRGoodsDetail 核心代码中分文件夹
CRGoodsDetail.podspec 文件中
# subspec 及各自的依赖私有库
s.subspec 'Module' do |m|
m.source_files = 'CRGoodsDetail/Classes/Module/*'
# 依赖私有库
m.dependency 'CRConfirmOrderServiceProtocol'
# 依赖公有库
m.dependency 'SDWebImage'
end
s.subspec 'Provider' do |p|
p.source_files = 'CRGoodsDetail/Classes/Provider/*'
p.dependency 'CRGoodsDetailServiceProtocol'
end
# 公用的依赖私有库
s.dependency 'CRProtocolManager'
使用 subspec 后 pod search 效果
Podfile 中使用 subspec
# pod 'CRGoodsDetail', :subspecs =>['Module'] #只加载本地 svn 私有库的某个 subspec
pod 'CRGoodsDetail' # 完整的 svn 私有库
五、图片资源、xib文件等
- 创建的 demo 工程中,组件相关的图片是放到 Assets 文件下
- spec 文件中需要添加
s.resource_bundles = { 'CRGoodsDetail' => ['CRGoodsDetail/Assets/*'] }
- 组件代码中加载图片不在是直接 imageName 了,图片打包的是一个 bundle 且 整个组件并不在 mainbundle 中,而是先要找到组件对应的 framework 包(可查看 Products 下,编译的 app 里的结构),然后找图片路径进行加载
- 组件中的 xib
- 使用 xib,以前的工程,xib 在 mainbundle 中。以组件形式的话,xib 在组件对应的 framework 包中
- xib 中的图片路径,跟上面一样需要添加图片资源包的相对路径
六、其他
- 使用 svn 的话,会提示输入用户名、密码,有时会因此报错,建议一开始就直接命令行
svn checkout xxx
一次,让电脑记住用户名、密码 - 重构是一个细心的工作,尤其是组件的抽取、剥离,一般会分业务层、基础层、功能层等,业务层里有各个的业务功能模块,基础层里有常量、宏、工具类、分类等,功能层里是能够抽取出来的某些具体功能方法,相同层内的不同组件不产生依赖,业务层会依赖基础层和功能层,基础层和功能层之间不依赖,实际工作中还需要具体情况具体对待
- 最后的主工程,需导入各个业务层里的组件,这里组件间的通信又是讨论的话题,url 、protocol、Target-Action等方案,自己也在学习和实践阶段,就不讨论,本文仅记录一些过程和问题。
基于 svn 服务器及 cocoapods-repo-svn 插件进行组件化私有库的创建的更多相关文章
- 转:Mac下搭建svn服务器和XCode配置svn
Mac下搭建svn服务器和XCode配置svn 先打开命令行终端. 1.创建svn repository svnadmin create /yourpath/svnroot/repository 2. ...
- svn使用---在CentOS 7上搭建SVN服务器 及windows搭建svn步骤
svn搭建方法: https://blog.csdn.net/helijie92902/article/details/51935122?foxhandler=RssReadRenderProcess ...
- Mac下搭建svn服务器和XCode配置svn
先打开命令行终端. 1.创建svn repository svnadmin create /yourpath/svnroot/repository 2.配置svn用户权限. / yourpath /s ...
- 工具第二天 cocoaPods 私有库的创建
之前介绍了cocoaPods的安装与使用,今天简单谈一下 自己的私有库运用cocoaPods依赖. cd到需要做库的工程目录下 创建一个podspec文件 创建:pod spec create 名称 ...
- 在已经部署svn 服务器上,搭建svn项目 成功版
1.进入svn目录,建立版本库 svnadmin create svntest svntest为svn项目名称 2. hooks/ 目录下新建 post-commit 文件 [钩子脚本] #!/bin ...
- ***使用jQuery去封装插件(组件化、模块化的思想),即扩展方法
如何使用jQuery去封装插件,区分扩展全局方法与扩展一个普通的jQuery实例对象的方法 1.给全局对象扩展方法:①$.方法 = function(参数可加可不加){} ②使用:$.方法(有参数的 ...
- ubuntu下手把手教你搭建SVN服务器
序,我的ubuntu服务器版本是14.04 ,x64(64位)操作系统,服务器在国内. 目录 一.安装SVN服务器 1 安装svn2 创建目录3 创建版本仓库4 配置5 启动SVN服务器6 验证svn ...
- Linux下SVN服务器搭建配置
Linux下SVN服务器搭建配置 1.SVN服务安装 yum install subversion 2.创建SVN代码仓库 mkdir /data/svn svnadmin create /data/ ...
- svn 服务器搭建
http://www.cnblogs.com/wrmfw/archive/2011/09/08/2170465.html 一,安装必须的软件包. $ apt-get install subversio ...
随机推荐
- 1.WF 4.5在项目中直接使用的问题
最近公司需要在互联网产品后台进行精细化流程管理,开发了一个基于WF 4.5框架的流程引擎与图形化设计器,让流程真正的跑了起来. 基于Visual Studio 直接设计流程主要面临以下的问题: 1.需 ...
- docker - 关于network的一些理解
docker 提供给我们多种(4种)网络模式,我们可以根据自己的需求来使用.例如我们在一台主机(host)或者同一个docker engine上面运行continer的时候,我们就可以选择bridge ...
- Java之枚举
1.定义 enum 是一种数据类型,与 全局常量比较相似,都是全局的并且是可以通过类名调用的 与全局常量区别 枚举功能更强大,可以有属性和方法 枚举比全局常量更加的规范 2.枚举特性 1)可以有属性以 ...
- Syntax error on tokens, delete these tokens.问题解决
问题:Syntax error on tokens, delete these tokens.(在标记语法错误,删除这些标记) 原因:存在中文字符或者符号(包括空格):单引号.双引号不匹配:复制的代码 ...
- 关于combotree的用法总结
后台: 实体树 public class TreeNode{ private String id; private String text; private String level; private ...
- C#开发移动应用系列(1.环境搭建)
前言 是时候蹭一波热度了..咳咳..我什么都没说.. 其实也是有感而发,昨天看到Jesse写的博文(是时候开始用C#快速开发移动应用了),才幡然醒悟 , 原来我们的Xamarin已经如此的成熟了... ...
- Redis 集群搭建详细指南
先有鸡还是先有蛋? 最近有朋友问了一个问题,说毕业后去大城市还是小城市?去大公司还是小公司?我的回答都是大城市!大公司! 为什么这么说呢,你想一下,无论女孩男孩找朋友都喜欢找个子高胸大的.同样的道理嘛 ...
- vue-router如何根据不同的用户给不同的权限
闲聊: 小颖去年在上家公司用的vue1.0之前在做路由这块用的router.map,但是现在vue2.0里已经不能用了,所以之前解决权限问题的例子,小颖也参考不了呜呜 之前看一个美女写的:elemem ...
- JS+PHP实现用户输入数字后取得最大的值并显示为第几个
目的:分清JS PHP的区别,拓宽思维 分析 1.利用JS的prompt输入用户想要输入的值. 2.利用HTML表单的text标签将输入的值传递给PHP处理文件 3.PHP进行数值判定,选出最大值和位 ...
- Ecshop去掉模版中随机出现Ecshop版权的方法
EC如果是免费用户用的话,模版里面会随机出现 powered by ecshop 的字样,看了一下原来是在COMMON.JS里面写的一段代码,删除掉就可以解决掉了,方法如下: 打开 js/commo ...