Latest 0.1.0
Homepage https://github.com/Tkoul/TKRouter
License MIT
Platforms ios 8.0
Authors

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 [email protected]{@"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 得到的值回调。==%@nnn",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.

Latest podspec

{
    "name": "TKRouter",
    "version": "0.1.0",
    "summary": "A short description of TKRouter.",
    "description": "TODO: Add long description of the pod here.",
    "homepage": "https://github.com/Tkoul/TKRouter",
    "license": {
        "type": "MIT",
        "file": "LICENSE"
    },
    "authors": {
        "Tkoul": "[email protected]"
    },
    "source": {
        "git": "https://github.com/Tkoul/TKRouter.git",
        "tag": "0.1.0"
    },
    "platforms": {
        "ios": "8.0"
    },
    "source_files": "TKRouter/Classes/**/*"
}

Pin It on Pinterest

Share This