TKRouter 0.1.1

TKRouter 0.1.1

Maintained by Tkoul.



TKRouter 0.1.1

  • By
  • Tkoul

TKRouter

CI Status Version License Platform

介绍

万能路由API功能:

1.Api万能路由利用AOP编程思想,指针参数,等来实现任意object-c 的API调用。支持基本数据类型,对象类型,代理,block,枚举,结构体等(系统自带和自定义均支持)

2.本sdk用于组件化开发模式,多sdk嵌套等复杂的情况!完全解决项目开发的耦合度!

背景

组件开发模式:在庞大项目开发下,有多个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变化即可。一般万年不遇!😄再说,一般都会迭代几个版本才会慢慢抛弃一些方法。

不要告诉我,你懒到自己代码写一遍,一万年都不再维护吧。😄

Example

调用注意:我们的所有的方法参数为指针类型!就牵涉到左值右值方面的知识。我们传的是左值-内存中有实际内存的。有兴趣的小伙伴可以研究下。 简单起见,如果是方法传来的值,直接使用会抱红,我们定义一个它的对象,接收一下值,用新定义的对象取地址即可。 左值、左值引用、右值、右值引用: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;

       Class TKMethodTestClass = [[TKRouter router] routerClassName:@"TKMethodTest"];

        //step 二: AOP 调用+ 方法。即类方法
        
        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];

以上是基本的调用,更多的download下来可自行查看。

比如:初始化ctrl,TKRouter给ctrl赋值,TKRouter调用push,推出新的视图,TKRouter设置代理!实现基本数据类型,结构体,oc类型,block块,代理等!

Installation

TKRouter is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod 'TKRouter'

Author

Tkoul, [email protected]

License

TKRouter is available under the MIT license. See the LICENSE file for more info.