背景:之前有看到QMUI_iOS這個(gè)UI框架救巷,發(fā)現(xiàn)里面幾乎涵蓋了所有常用的UI控件了,而且支持通過(guò)配置文件方便的實(shí)現(xiàn)更換主題、統(tǒng)一按鈕顏色挽懦、tableviewcell高度等,就想去體驗(yàn)一把剃浇,這次想寫一個(gè)組件化的demo就剛好用上辣~~~
總體來(lái)說(shuō)使用CTMediator實(shí)現(xiàn)組件化,主要?dú)v經(jīng)兩大步驟:
1.基于之前做的APP原型完成基于CTMediator和QMUI_iOS的完整Demo巾兆,PXProject.
2.新建主工程PXMainProject,將Demo的各個(gè)組件和各模塊做成私有庫(kù)虎囚,最后演變成orgnization HelloPixie
基于CTMediator和QMUI的完整Demo
在之前項(xiàng)目(花都)的原型上用QMUI搭建各個(gè)界面(基本能覆蓋百分之八九十的常見(jiàn)UI控件)角塑。
1.模塊拆分
(1)功能模塊
將項(xiàng)目拆分成Tabbar(PXTabBarViewController)、首頁(yè)(PXHome)淘讥、接種計(jì)劃(PXVaccinationPlans)圃伶、健康(PXHealth)、個(gè)人中心(PXPersonalCenter)五大功能模塊模塊
(2)通用組件
異常處理(PXNoTarget)、空頁(yè)面(PXEmptyView_Category)窒朋、控制器通用配置(QMUICommonViewController_Category)
(3)QMUI配置文件(APP控件顏色搀罢,高度等配置項(xiàng))
QMUIConfigurationTemplate
Tips:這些模塊和組件應(yīng)該是平級(jí)的,在一個(gè)項(xiàng)目中不應(yīng)該有g(shù)eneral等文件夾侥猩,所有的功能或者模塊應(yīng)該都是平級(jí)的榔至,便于維護(hù)和管理.
2.功能編寫
要點(diǎn):
推薦QMUI_iOS_CodeSnippets代碼塊提升編碼效率
和QMUI_iOS_Templates這個(gè)還沒(méi)用,需要管理員權(quán)限安裝欺劳,配合QMUI使用唧取。模塊間的引用通過(guò)CTMediator Category來(lái)降低耦合,可以先將本模塊對(duì)外通信的Category設(shè)計(jì)出來(lái)划提,可以做到不影響其他模塊的代碼編寫枫弟,并行任務(wù)。
每個(gè)模塊都有一個(gè)對(duì)應(yīng)的Target_XXX,負(fù)責(zé)提供對(duì)外的接口鹏往,這里面Action不局限于返回ViewController淡诗,還能做上傳任務(wù)等,它的本質(zhì)就是對(duì)外業(yè)務(wù)的一層服務(wù)化封裝伊履。Target_XXX可以引用本模塊的各個(gè)文件韩容,對(duì)應(yīng)的CTMediator Category調(diào)用Target的相關(guān)Action解耦。
將Demo的各個(gè)組件和各模塊做成私有庫(kù)
參考文章Casa在現(xiàn)有工程中實(shí)施基于CTMediator的組件化方案
具體步驟:
創(chuàng)建一個(gè)orgnization湾碎,里面應(yīng)該有個(gè)MainProject主工程(將之前PXProject里面的功能模塊拆出去宙攻,只剩下QMUIConfigurationTemplate、PXPTabBarSetting.plist)
再去開(kāi)一個(gè)repo介褥,這個(gè)repo就是我們私有Pod源倉(cāng)庫(kù)
pod repo add [私有Pod源倉(cāng)庫(kù)名字] [私有Pod源的repo地址]
創(chuàng)立一個(gè)文件夾座掘,例如Project。把我們的主工程文件夾放到Project下:~/Project/MainProject
在~/Project下clone快速配置私有源的腳本repo:git clone git@github.com:casatwy/ConfigPrivatePod.git
將ConfigPrivatePod的template文件夾下Podfile中source 'https://github.com/ModulizationDemo/PrivatePods.git'改成第一步里面你自己的私有Pod源倉(cāng)庫(kù)的repo地址
將ConfigPrivatePod的template文件夾下upload.sh中PrivatePods改成第二步里面你自己的私有Pod源倉(cāng)庫(kù)的名字
接下來(lái)是私有庫(kù)的創(chuàng)建過(guò)程:
- 創(chuàng)建各個(gè)模塊的工程柔滔,放置Project文件夾下溢陪,與ConfigPrivatePod平級(jí)目錄
- cd到ConfigPrivatePod下,執(zhí)行./config.sh腳本來(lái)配置這個(gè)私有Pod(在XCode工程的代碼目錄下新建一個(gè)跟項(xiàng)目同名的目錄睛廊。放在這個(gè)目錄下的代碼就會(huì)隨著Pod的發(fā)版而發(fā)出去形真,這個(gè)目錄以外的代碼就不會(huì)跟隨Pod的版本發(fā)布而發(fā)布)
- 修改podfile 和 .podspec文件(添加三方庫(kù)依賴/支持系統(tǒng)版本/圖片資源...)
特別注意:將圖片資源作為resource_bundles引入時(shí).podspec應(yīng)該是下面這樣
s.resource_bundles = {
'PXHome' => ['PXHome/PXHome/Assets/*.xcassets']
}
獲取圖片時(shí),代碼應(yīng)該是這樣:
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;
}
- 發(fā)布私有庫(kù)及關(guān)聯(lián)本地代碼到遠(yuǎn)程倉(cāng)庫(kù)
注意:修改upload.sh文件超全,將最后一行發(fā)布命令最后的一個(gè)參數(shù)去掉咆霜,否則會(huì)報(bào)錯(cuò),如果私有庫(kù)里面包含了私有庫(kù),需要指定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
提交并上傳私有庫(kù)
git add .
git commit -m "版本號(hào)"
git tag 版本號(hào)
git push origin master --tags
./upload.sh
要注意的是蛾坯,這里的版本號(hào)要和podspec文件中的s.version給到的版本號(hào)一致。upload.sh是配置私有Pod的腳本生成的疏遏,如果你這邊沒(méi)有upload.sh這個(gè)文件脉课,說(shuō)明這個(gè)私有Pod你還沒(méi)用腳本配置過(guò)救军。
重復(fù)上述幾個(gè)步驟,完成對(duì)各個(gè)模塊的發(fā)版工作倘零,最后唱遭,在PXMainProject的podfile將創(chuàng)建的私有庫(kù)引入進(jìn)來(lái),編譯呈驶、運(yùn)行拷泽、大功告成。
遠(yuǎn)程調(diào)用
上面是本地調(diào)用的方式袖瞻,遠(yuǎn)程調(diào)用使用以下API即可(參考Target_PXPersonalCenter):
// 遠(yuǎn)程App調(diào)用入口跌穗,或者banner的跳轉(zhuǎn)等都可使用
// url sample: aaa://targetA/actionB?id=1234
- (id)performActionWithUrl:(NSURL *)url completion:(void(^)(NSDictionary *info))completion