What
这是一个非常小的app内路由工具，你可以用他来处理来自推送，urlschema，universal url，深链，网页调用，app的消息中心的消息或者调用，还可以用于服务器下发跳转逻辑，例如banner。相比其他同类库，它具有如下特点
- 支持自由，所见即所得的路由处理函数
- 支持自动跳转和手动跳转
- 支持参数自动填充
- 支持参数keymap
- 支持“二段跳”，即next关键字
- 支持跳转后返回并携带数据
- 支持数据暂存，类似剪贴板
使用方法
安装
在podfile中添加 pod 'HGoto'并更新
配置
实现HGotoConfig协议
#import "HGoTo.h"
@interface HGotoConfigIMP : NSObject <HGotoConfig>
@end
#import "HGotoConfigIMP.h"
#import <HCommon.h>
@implementation HGotoConfigIMP
HRegForProtocal(HGotoConfig)
- (NSString *)appSchema
{
return @"HGoto://";
}
- (UINavigationController *)navi
{
return [UIApplication navi];
}
@end
注意其中HRegForProtocal(HGotoConfig) 是一个注册方式，告诉上下文，取这个协议的对象来找他
基本使用
你想添加一个对BViewController的跳转，并携带参数，那么设计好的链接如下
你的schema://b?pa=1&pb=2&pc=3
你需要
1.在VC的imp里面注册路径HGotoReg(@"b")
2.如果需要处理参数的话，需要编写参数处理函数hgoto_xxxxx
@implementation BViewController
- (void)viewDidLoad
{
[super viewDidLoad];
self.title = @"B";
self.view.backgroundColor = [UIColor blueColor];
UITextView *textView = [[UITextView alloc] initWithFrame:self.view.bounds];
self.view = textView;
textView.text = [NSString stringWithFormat:@"pa=%@,pb=%d,pc=%@", self.pa,self.pb,self.pc];
}
@end
//有一定逻辑的情况下，建议放在一个扩展里面实现路由
@implementation BViewController (hgoto)
HGotoReg(@"b")
+ (void)hgoto_pa:(NSString *)pa pb:(NSString *)pb pc:(NSString *)pc finish:(finish_callback)finish
{
BViewController *vc = [HGoto autoRoutedVC];
vc.pa = pa;
vc.pb = [pb intValue];
vc.pc = @([pc intValue]);
vc.gotoCallback = finish;
}
@end
注意：[HGoto autoRoutedVC] 是已经帮你创建好的VC 3.在浏览器地址栏填入"你的schema://b?pa=1&pb=2&pc=3"试试吧，注意要确认你的schema在info.plist的url-types里面
参数处理函数模板
需要处理参数时任选一个模式即可，其中模式1的函数方法名，由路由的入参决定，当然，少几个参数是没问题的
模式1 + (void)hgoto_p1:(NSString *)p1 p2:(NSString *)p2 p3:(NSString *)p3 finish:(finish_callback)finish 模式1 + (void)hgoto_P1:(NSString *)p1 p2:(NSString *)p2 p3:(NSString *)p3 模式2 + (void)hgotoWithParams:(NSDictionary *)paramMap finish:(finish_callback)finish 模式2 + (void)hgotoWithParams:(NSDictionary *)paramMap 模式3 + (void)hgoto:(NSString *)params finish:(finish_callback)finish 模式3 + (void)hgoto:(NSString *)params 模式4 + (void)hgotoWithFinish:(finish_callback)finish 模式4 + (void)hgoto
有的带回调，有的没带回调，按需使用就可以了
手动处理跳转请求
如果需要完全自己创建对象，设置参数，跳转，直接使用HGotoOpt_ManualRoute这个注解即可
@implementation CViewController1
HGotoReg2(@"c1",HGotoOpt_ManualRoute)
- (void)viewDidLoad
{
[super viewDidLoad];
self.title = @"C1";
}
+ (void)hgoto_pa:(NSString *)pa
{
[[UIApplication navi] pushViewController:[CViewController1 new] animated:YES];
}
@end
注意，添加了这个参数，那么跳转目的地就可以不只是VC了，可以是任意NSObject子类，如果你要用这个做成一个命令或者方法调用，也是可以的
自动填充参数
类似于这种赋值没有多大意义
BViewController *vc = [HGoto autoRoutedVC];
vc.pa = pa;
vc.pb = [pb intValue];
vc.pc = @([pc intValue]);
vc.gotoCallback = finish;
如果想省略掉的话，可以使用HGOtoOpt_AutoFill这个注解
@implementation CViewController3
HGotoReg2(@"c3",HGOtoOpt_AutoFill)
- (void)viewDidLoad
{
[super viewDidLoad];
self.title = @"C3";
UITextView *textView = [[UITextView alloc] initWithFrame:self.view.bounds];
self.view = textView;
textView.text = [NSString stringWithFormat:@"pa=%@,PB=%d,pc=%@", self.pa,self.PB,self.pc];
}
@end
这样，参数处理函数都省掉了
参数映射
在HGOtoOpt_AutoFill模式中，如果入参和你定义的属性名字不太一样，那么你需要做一下参数映射，使用HGOtoOpt_KeyMap这个注解即可
@implementation CViewController4
HGotoReg2(@"c4", HGOtoOpt_AutoFill, HGOtoOpt_KeyMap((@{@"pa":@"eee",@"pb":@"FFF",@"pc":@"ggg"})))
- (void)viewDidLoad
{
[super viewDidLoad];
self.title = @"C4";
UITextView *textView = [[UITextView alloc] initWithFrame:self.view.bounds];
self.view = textView;
textView.text = [NSString stringWithFormat:@"eee=%@,FFF=%d,ggg=%@", self.eee,self.FFF,self.ggg];
}
@end
唯一VC处理
有一个页面叫CViewController2，这个页面比较重，页面栈里面只允许出现一个，如果在有跳转的情况需要退栈，对应这种需求，使用HGOtoOpt_AutoPop这个注解即可
@implementation CViewController2
HGotoReg2(@"c2",HGOtoOpt_AutoPop)
- (void)viewDidLoad
{
[super viewDidLoad];
self.title = @"C2";
UITextView *textView = [[UITextView alloc] initWithFrame:self.view.bounds];
self.view = textView;
textView.text = self.pa;
}
- (void)setPa:(NSString *)pa
{
_pa = pa;
[(UITextView *)self.view setText:pa];
}
+ (void)hgoto_pa:(NSString *)pa
{
CViewController2 *vc = [HGoto autoRoutedVC];
vc.pa = pa;
}
@end
可以使用如下代码测试
[HGoto route:@"HGoto://c2?pa=oldoldoldoldoldoldoldoldoldoldoldold&pb=2&pc=3"];
[HGoto route:@"HGoto://b"];
dispatchAfter(2, ^{
[HGoto route:@"HGoto://c2?pa=newnewnewnewnewnewnewnewnewnewnewnew&pb=2&pc=3"];
});
直接获取VC
默认我们的跳转方式都是push，如果需要不同的跳转方式，需要自己手动跳转， 但是对于同一个VC，有时候需要push，有时候需要pop，这种情况下，可以使用这个方法
+ (UIViewController *)getViewController:(NSString *)path;
直接获取到VC对象，并且在不同地方采用不同的跳转方式