5步教你快速写一个android Router路由框架
程序员文章站
2023-08-12 13:02:26
router路由框架
什么是路由?说简单点就是映射页面跳转关系的,当然它也包含跳转相关的一切功能。
前言
网上大片的路由框架实在太多了,实现的方式都大同小异,...
router路由框架
什么是路由?说简单点就是映射页面跳转关系的,当然它也包含跳转相关的一切功能。
前言
网上大片的路由框架实在太多了,实现的方式都大同小异,通过注解实现路由表;但是在多module开发的时候怎么合并路由表,不同的框架有着自己的解决方案。
arouter:通过类查找进行合并路由表。
activityrouter:通过注解进行路由表合并。
路由框架的意义
android系统已经给我们提供了api来做页面跳转,比如startactivity,为什么还需要路由框架呢?我们来简单分析下路由框架存在的意义:
- 在一些复杂的业务场景下,灵活性比较强,很多功能都是动态配置的,比如下发一个活动页面,我们事先并不知道具体的目标页面,但如果事先做了约定,提前做好页面映射,便可以*配置。
- 随着业务量的增长,客户端必然随之膨胀,开发人员的工作量越来越大,比如64k问题,比如协作开发问题。app一般都会走向组件化的道路,而组件化的前提就是解耦,那么我们首先要做的就是解耦页面之间的依赖关系。
- 简化代码。数行跳转代码精简成一行代码。
特性
router有哪些特性或者优点呢?
- 基于注解,使用方便,源码简洁
- 链式调用,api友好
- 多路径支持
- 结果回调,每次跳转都会回调跳转结果
- 编译期处理注解,不影响运行时性能
- 除了可以使用注解定义路由,还支持手动分配路由
- 自定义拦截器,可以对路由进行拦截,比如登录判断和埋点处理
- 自定义路由匹配规则,相比较其他路由框架,该项目并没有限制路由的写法,除了内置的几个匹配器,用户完全可以定义自己的规则
- 支持隐式intent跳转
- 支持多模块使用,支持组件化开发
- 不仅支持注解activity,还支持注解fragment
- 支持kotlin
开始
对于路由表的合并我采用了activityrouter的方案,进行注解合并路由表。
1.源码:
if (!hasmodules && !hasmodule){ //普通app createrapprouterhelper(); } if (hasmodule){ //保存每个module中的路由表 creatermodulehelper(modulename); } if (hasmodules){ //合并每个module中的路由表 createrrouterhelper(modulenames); }
2.用法:
app:
@module("app") @modules({"app","module"}) public class app extends application{ ... }
module:
@module("module") @path("module") public class moduleactivity extends appcompatactivity { ... }
3.备注:非多module开发以上直接省略直接初始化路由即可
初始化
router.init(this.getapplicationcontext());//bixu router.debug(true);//开启debug模式
页面跳转
程序内部界面之间跳转 通过 path 查找路由表中 对应的activity 进行页面跳转。
外部跳转程序内部 通过 uri 拦截 activity 对uri进行拦截处理并最终通过路由表查找 path进行跳转。
1.用法
基本用法
router.getinstance().path("second"); router.getinstance().action(mediastore.action_image_capture); router.getinstance().uri("https://www.waws.top/module?id=2&name=haha");
okhttp式用法
//同步request request = new request.builder(this).path("second").build(); response response = router.getinstance().newcall(request).execute(); //异步request = new request.builder(this) .path("second") .responsecode(100) .resultcallback(new resultcallback() { @override public void next(int resultcode, intent data) { routerlog.d("resultcode:"+resultcode+"\ndata:"+data.getstringextra("tag")); } }) .addoption(activityoptions.makescenetransitionanimation(this,bt,"share").tobundle()) .build(); router.getinstance().skipintecepter().newcall(request) .enqueue(new routercallback() { @override public void next(response response) { routerlog.d(response.tostring()); } });
拦截activity onactivityresult 使用了代理fragment进行动态拦截,有兴趣的可以看源码,地址在下边
拦截器
支持全局拦截并支持降级操作
router.addintecepter(new routerintecepter() { @override public request chain(request request) { //todo: return request; } @override public void onlost(string msg) { //todo: log.d("app", "onlost: "+msg); } @override public void onsuccess() { //todo: log.d("app", "onsuccess: "); } });
外部跳转app内部进行如下配置
<activity android:name=".dispatcheractivity"> <intent-filter> <action android:name="android.intent.action.view"/> <category android:name="android.intent.category.browsable"/> <category android:name="android.intent.category.default"/> <!-- start --> <!-- 修改如下data信息即可 --> <data android:scheme="http" android:host="www.waws.top"/> <data android:scheme="https" android:host="www.waws.top"/> <data android:scheme="router" android:host="www.waws.top"/> <!-- end --> </intent-filter></activity>
源码地址:https://github.com/waws80/router
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。