万能API路由(api任意调用,组件完全解耦)-iOS
介绍:
万能API路由通过AOP,KVC,指针入参数等编程思想,实现类,实例方法的任意调用,因为使用指针入参,支持C语言的基本数据类型,oc对象类型,结构体,block块,代理等,通过kvc来实现属性的动态赋值操作。实现大型app任意模块之间的解耦。特别对于大型依赖pod管理开发的组件相互依赖,更是解决不同sdk底层依赖相同库产生的冲突,使得各个sdk完全解耦!
万能路由API功能:
1.Api万能路由利用AOP编程思想,指针参数,等来实现任意object-c 的API调用。支持基本数据类型,对象类型,代理,block,枚举,结构体等(系统自带和自定义均支持)
2.本sdk用于组件化开发模式,多sdk嵌套等复杂的情况!完全解决项目开发的耦合度!
组件已开源,地址:https://github.com/Tkoul/TKRouter
pod引入 : pod'TKRouter'
如果找不到,删除本地pod缓存索引,更新下spec库即可。
设计背景:
组件开发模式:在庞大项目开发下,有多个sdk共同开发。主app就是一个空壳,各个组件sdk开发完毕,进行pod验证,打tag,执行repo push操作,最后提交到公司仓库。最后只要在主app进行多pod依赖,一键pod update !把各个组件sdk拉下来!这就是最常用的组件开发。本人所在公司也是这种开发模式。
组件化开发的好处这里不做赘述!网上有很多资料,可以说大的项目已经离不开组件化的思想。
组件化路由:那么在这样的开发模式下,效率大大提升,并且分工明确,各个团队之间有条不紊。而在各个团队之间的桥梁--路由的作用就不言而喻!常规的路由,包括目前流行的路由三方组件都有自己的定义规则,一个项目突然适配起来不是那么简单。
开发问题:项目主App,包含多个组件(举个例子,比如就2个把,像京东商城,支付宝这个级别的有个百十个吧),比如其中一个组件A,一个组件B。分别有俩个团队负责开发,都有自己完整的流程!那么两个库都依赖了AFNetworking 这个请求第三方(大公司会封装自己的请求框架轮子)。这里依照afnet为例子吧,毕竟太牛!哈哈
A单独开发:A项目,引入pod 'AFNetworking', '~> 3.0' 然后 高高兴兴去开发了,在项目期限结束的时候,打tag,pod lib验证,pod repo push 完事。
B单独开发:B为老组件,很早就引入pod 'AFNetworking', '~> 2.0' 然后 高高兴兴去开发了,在项目期限结束的时候,打tag,pod lib验证,pod repo push 完事。两个对很ok!
主app进行pod依赖,把各个组件下拉 pod 'A组件', pod 'B组件'!
1.这个时候执行pod update 就出现问题了 拉不下来,因为pod版本不兼容。 记做 问题一
主APP负责人看了,会有两种解决方案
方案一:立即联系B,告知版本库升级到3.0用新的,告知所有的团队以某个版本为准。
方案二:把AFNetworking作为主App的直接bundel内容,其它组件去掉AFNetworking
对于方案一:版本冲突解决了,但是有100个组件 依赖了100个AFNetworking,有的组件提供源码,没问题,源码只会拉一份,有的提供的framework,经过pod打包默认加前缀的(无--no-mangle命令)!也就是有多少个静态库提供的组件,就会生成同样功能的AFNetworking,比如有50个组件是静态库,那么最后拉下来就会有51个AFNetworking存在项目中。(如果不加--no-mangle)对于静态库类型的组件,就会报错有很多个重复文件。---记做问题二
对于方案二:主app管理AFNetworking,那么在A和B单独开发的时候,不能依赖AFNetworking,只能导入主.h文件,把AFNetworking作为demoApp加入demo工程。也可以正常开发。但是进行pod lib 和 pod repo push的时候就推不上仓库了!因为pod验证会检测实现方法等,相当于少了AFNetworking库,压根过不去。--记做问题三
以上问题对组件特别的APP开发造成很大的困扰!为了解决这个问题,大牛们早就前行在道路上,就出现了“组件二进制化||平滑二进制组件”的实现,本人也在使用。原理就是把第三方共用组件比如AFNetworking先做成二进制文件,大家都依赖二进制文件来做到统一!能极大解决问题,弊端就是维护很多二进制,并且每次升级不同团队都要做二进制文件的md5哈希取值,这个值一样才能说明是同一个!每次代码升级开发完毕,必须把源码重新生成新的二进制,维护成本很高!有时候就忘了!
针对诸多的问题,我就尝试了TKRouter的实现。
TKRouter :
1.调用原子api ,没有什么规则,就像调用方法一样。
2.多组件开发,都依赖某些第三方组件的时候,比如AFNetworking,我们一旦确定几百个团队有一个在用AFNetworking,那么我们就不管依赖的事情了 甚至不去维护它,瞅一眼都懒! 我们就直接路由调用。我们的项目和AFNetworking无任何直接关系,头文件都不需要引入。
下面是我的某个组件调用AFNetworking的网络检测代码:
常规实现:
1. 项目依赖 AFNetworking
2. 实现的地方引入 AFNetworkReachabilityManager.h
3. 实现如下代码
AFNetworkReachabilityManager *maneage=[AFNetworkReachabilityManager sharedManager];
[maneage startMonitoring];
[maneage setReachabilityStatusChangeBlock:^(AFNetworkReachabilityStatus status) {
if (status == 0) {
//无网络链接
} else {
//有网链接
}
}];
TKRouter 实现:直接上代码 ,不要依赖,不需要引入头文件:
ReturnStruct managerStur = [[[TKRouter router] routerClassName:@"AFNetworkReachabilityManager"] classMethodSelect:@"sharedManager" parameter:nil, nil];
NSObject *objManager = managerStur.returnValue;
[objManager instanceMethodSelect:@"startMonitoring" parameter:nil, nil];
void (^ReachabilityStatusChangeBlock)(NSInteger status) = ^(NSInteger status){
if (status == 0) {
//无网络链接
} else {
//有网链接
}
};
[objManager instanceMethodSelect:@"setReachabilityStatusChangeBlock:" parameter:&ReachabilityStatusChangeBlock, nil];
TKRouter好处就是不需要关心依赖的框架,只要主APP或者主APP依赖的诸多组件sdk有一份我就能运行通过TKRouter调用,组件工程不存在AFNetworking也依然可与执行pod lib lint 和 pod repo push!推送的是组件,想达到实际效果就在demo工程手动导入一下AFNetworking即可。pod推送,验证跟demo工程无关。
那么 以上的诸多问题全部得到解决!且无任何成本!
注意事项:TKRouter 强大的原子调用毋庸置疑,三方sdk一旦开源!api就固定了,所以主工程种几百个组件有一个AFNetworking就够了,因为AFNetworking的api一般不会随着版本升级而变更,只会里面的实现会有所变更。但是咱们不关心啊,有其他团队维护呢。😄
好处:咱们不用关系他升级到第几个版本,让别的团队更新维护版本,而我们只关注api!
注意:某个开源库万不得已改变了api! 那么由于我们用的路由aop思想编写出来的程序,api变化,我们组件并没有报错,红点提示。所以每次开源库大版本升级关注下api变化即可。一般万年不遇!😄再说,一般都会迭代几个版本才会慢慢抛弃一些方法。
不要告诉我,你懒到自己代码写一遍,一万年都不再维护吧。😄
调用注意:我们的所有的方法参数为指针类型!就牵涉到左值右值方面的知识。我们传的是左值-内存中有实际内存的。有兴趣的小伙伴可以研究下。简单起见,如果是方法传来的值,直接使用会抱红,我们定义一个它的对象,接收一下值,用新定义的对象取地址即可。左值、右值:https://www.jianshu.com/p/8095517dbb3f
核心方法:
一:
/**
实例子对象 给属性 赋值
@param propertyParameter 属性字典组合。 key为属性的字符串。 value为属性需要赋予的值
@return 返回
*/
- (ReturnStruct)setPropertyParameter:(NSDictionary*)propertyParameter;
二:
/**
执行实例方法
@param selectString 方法名
@param methodParaments 方法参数 --- 指针参数 对应参数 以指针类型传入
@return 返回值
*/
- (ReturnStruct)instanceMethodSelect:(NSString*)selectString parameter:(void *)methodParaments, ... NS_REQUIRES_NIL_TERMINATION;
三:
/**
执行类方法
@param selectString 方法名
@param methodParaments 方法参数 --- 指针参数 对应参数 以指针类型传入
@return 返回值
*/
+ (ReturnStruct)classMethodSelect:(NSString*)selectString parameter:(void *)methodParaments, ... NS_REQUIRES_NIL_TERMINATION;
示例:
比如在demo工程:
调用方法:+ (NSString*)TestMethodOneWithObjectType:(NSDictionary*)dic andPar:(NSString*)strOne andPar:(NSNumber*)numTwo;
//step 二: AOP 调用+ 方法。即类方法
Class TKMethodTestClass = [[TKRouter router] routerClassName:@"TKMethodTest"];
NSDictionary *par1 =@{@"key1":@"Hello:TKRouter",@"key2":@"SayHi"};
NSString *par2 = @"字符串类型参数";
NSNumber *par3 = [NSNumber numberWithInt:1688];
[TKMethodTestClass classMethodSelect:@"TestMethodOneWithObjectType:andPar:andPar:" parameter:&par1,&par2,&par3, nil];
调用方法:- (void)TestMethodTwoWithBasicType:(int)numberone andSecond:(CGFloat)floatTwo;
//step 四-: 实例对象调用- 方法 - 传入基本数据类型
NSObject *object = [[TKRouter router] routerGetInstanceWithClassName:@"TKMethodTest"];
int par4 = 8888;
CGFloat par5 = 88.88;
ReturnStruct returnOne = [object instanceMethodSelect:@"TestMethodTwoWithBasicType:andSecond:" parameter:&par4,&par5, nil];
调用方法:- (BOOL)TestMethodTwoWithStructType:(CGRect)struOne and:(CGSize)struTwo;
//step 四二: 实例对象调用- 方法 - 传入结构体
NSObject *object = [[TKRouter router] routerGetInstanceWithClassName:@"TKMethodTest"];
CGRect par6 = CGRectMake(100, 100, 200.5, 200);
CGSize par7 = CGSizeMake(666.0, 888.5);
ReturnStruct returnTwo = [object instanceMethodSelect:@"TestMethodTwoWithStructType:and:" parameter:&par6,&par7, nil];
调用方法:- (NSString*)TestMethodTwoWithBlockType:(void(^)(NSString *str1))block;
//step 四三: 实例对象调用- 方法 - 传入block块
NSObject *object = [[TKRouter router] routerGetInstanceWithClassName:@"TKMethodTest"];
void(^parblock8)(NSString *str1) = ^(NSString *str1){
NSLog(@"\n block 得到的值回调。==%@\n\n\n",str1);
};
ReturnStruct returnThere = [object instanceMethodSelect:@"TestMethodTwoWithBlockType:" parameter:&parblock8, nil];
以上是基本的调用,更多的去github上download下来可自行查看。(地址:https://github.com/Tkoul/TKRouter)
比如:初始化ctrl,TKRouter给ctrl赋值,TKRouter调用push,推出新的视图,TKRouter设置代理!实现基本数据类型,结构体,oc类型,block块,代理等!
如果有帮到你,请去俺的https://github.com/Tkoul/TKRouter地址上 star一下。
欢迎大家交流,email:Tkoull@163.com