使用QMUI_iOS和CTMediator实现组件化

背景:之前有看到QMUI_iOS这个UI框架,发现里面几乎涵盖了所有常用的UI控件了,而且支持通过配置文件方便的实现更换主题、统一按钮颜色、tableviewcell高度等,就想去体验一把,这次想写一个组件化的demo就刚好用上辣~~~
总体来说使用CTMediator实现组件化,主要历经两大步骤:

1.基于之前做的APP原型完成基于CTMediator和QMUI_iOS的完整Demo,PXProject.

2.新建主工程PXMainProject,将Demo的各个组件和各模块做成私有库,最后演变成orgnization HelloPixie

基于CTMediator和QMUI的完整Demo

在之前项目(花都)的原型上用QMUI搭建各个界面(基本能覆盖百分之八九十的常见UI控件)。

1.模块拆分

(1)功能模块
将项目拆分成Tabbar(PXTabBarViewController)、首页(PXHome)、接种计划(PXVaccinationPlans)、健康(PXHealth)、个人中心(PXPersonalCenter)五大功能模块模块
(2)通用组件
异常处理(PXNoTarget)、空页面(PXEmptyView_Category)、控制器通用配置(QMUICommonViewController_Category)
(3)QMUI配置文件(APP控件颜色,高度等配置项)
QMUIConfigurationTemplate
Tips:这些模块和组件应该是平级的,在一个项目中不应该有general等文件夹,所有的功能或者模块应该都是平级的,便于维护和管理.

2.功能编写

要点:

  • 推荐QMUI_iOS_CodeSnippets代码块提升编码效率
    QMUI_iOS_Templates这个还没用,需要管理员权限安装,配合QMUI使用。

  • 模块间的引用通过CTMediator Category来降低耦合,可以先将本模块对外通信的Category设计出来,可以做到不影响其他模块的代码编写,并行任务。

  • 每个模块都有一个对应的Target_XXX,负责提供对外的接口,这里面Action不局限于返回ViewController,还能做上传任务等,它的本质就是对外业务的一层服务化封装。Target_XXX可以引用本模块的各个文件,对应的CTMediator Category调用Target的相关Action解耦。

将Demo的各个组件和各模块做成私有库

参考文章Casa在现有工程中实施基于CTMediator的组件化方案

具体步骤:

  1. 创建一个orgnization,里面应该有个MainProject主工程(将之前PXProject里面的功能模块拆出去,只剩下QMUIConfigurationTemplate、PXPTabBarSetting.plist)

  2. 再去开一个repo,这个repo就是我们私有Pod源仓库

  3. pod repo add [私有Pod源仓库名字] [私有Pod源的repo地址]

  4. 创立一个文件夹,例如Project。把我们的主工程文件夹放到Project下:~/Project/MainProject

  5. 在~/Project下clone快速配置私有源的脚本repo:git clone git@github.com:casatwy/ConfigPrivatePod.git

  6. 将ConfigPrivatePod的template文件夹下Podfile中source 'https://github.com/ModulizationDemo/PrivatePods.git'改成第一步里面你自己的私有Pod源仓库的repo地址

  7. 将ConfigPrivatePod的template文件夹下upload.sh中PrivatePods改成第二步里面你自己的私有Pod源仓库的名字

接下来是私有库的创建过程:

  1. 创建各个模块的工程,放置Project文件夹下,与ConfigPrivatePod平级目录
  2. cd到ConfigPrivatePod下,执行./config.sh脚本来配置这个私有Pod(在XCode工程的代码目录下新建一个跟项目同名的目录。放在这个目录下的代码就会随着Pod的发版而发出去,这个目录以外的代码就不会跟随Pod的版本发布而发布)
  3. 修改podfile 和 .podspec文件(添加三方库依赖/支持系统版本/图片资源...)

特别注意:将图片资源作为resource_bundles引入时.podspec应该是下面这样

    s.resource_bundles = {
        'PXHome' => ['PXHome/PXHome/Assets/*.xcassets']
    }

获取图片时,代码应该是这样:

UIImage *image = [self getImageWithBoudleName:@"PXHome" imgName:dic[@"image"]];

- (UIImage *)getImageWithBoudleName:(NSString *)boudleName imgName:(NSString *)imgName {
    NSBundle *bundle = [NSBundle bundleForClass:[self class]];
    NSURL *url = [bundle URLForResource:boudleName withExtension:@"bundle"];
    NSBundle *targetBundle = [NSBundle bundleWithURL:url];
    UIImage *image = [UIImage imageNamed:imgName
                                inBundle:targetBundle
           compatibleWithTraitCollection:nil];
    return image;
}
  1. 发布私有库及关联本地代码到远程仓库

注意:修改upload.sh文件,将最后一行发布命令最后的一个参数去掉,否则会报错,如果私有库里面包含了私有库,需要指定sources,类似于:

pod repo push PXPrivatePods PXHome.podspec --sources=https://gitee.com/HelloPixie/PrivatePods.git,https://github.com/CocoaPods/Specs.git --verbose --allow-warnings --use-libraries
提交并上传私有库
git add .
git commit -m "版本号"
git tag 版本号
git push origin master --tags
./upload.sh

要注意的是,这里的版本号要和podspec文件中的s.version给到的版本号一致。upload.sh是配置私有Pod的脚本生成的,如果你这边没有upload.sh这个文件,说明这个私有Pod你还没用脚本配置过。
重复上述几个步骤,完成对各个模块的发版工作,最后,在PXMainProject的podfile将创建的私有库引入进来,编译、运行、大功告成。

远程调用

上面是本地调用的方式,远程调用使用以下API即可(参考Target_PXPersonalCenter):

// 远程App调用入口,或者banner的跳转等都可使用
// url sample: aaa://targetA/actionB?id=1234
- (id)performActionWithUrl:(NSURL *)url completion:(void(^)(NSDictionary *info))completion
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,185评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,445评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,684评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,564评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,681评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,874评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,025评论 3 408
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,761评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,217评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,545评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,694评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,351评论 4 332
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,988评论 3 315
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,778评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,007评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,427评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,580评论 2 349