5步教你快速写一个android Router路由框架

Router路由框架

什么是路由?说简单点就是映射页面跳转关系的,当然它也包含跳转相关的一切功能。

前言

网上大片的路由框架实在太多了,实现的方式都大同小异,通过注解实现路由表;但是在多module开发的时候怎么合并路由表,不同的框架有着自己的解决方案。

ARouter:通过类查找进行合并路由表。

ActivityRouter:通过注解进行路由表合并。

路由框架的意义

Android系统已经给我们提供了api来做页面跳转,比如startActivity,为什么还需要路由框架呢?我们来简单分析下路由框架存在的意义:

  1. 在一些复杂的业务场景下,灵活性比较强,很多功能都是动态配置的,比如下发一个活动页面,我们事先并不知道具体的目标页面,但如果事先做了约定,提前做好页面映射,便可以自由配置。
  2. 随着业务量的增长,客户端必然随之膨胀,开发人员的工作量越来越大,比如64K问题,比如协作开发问题。App一般都会走向组件化的道路,而组件化的前提就是解耦,那么我们首先要做的就是解耦页面之间的依赖关系。
  3. 简化代码。数行跳转代码精简成一行代码。

特性

Router有哪些特性或者优点呢?

  1. 基于注解,使用方便,源码简洁
  2. 链式调用,api友好
  3. 多路径支持
  4. 结果回调,每次跳转都会回调跳转结果
  5. 编译期处理注解,不影响运行时性能
  6. 除了可以使用注解定义路由,还支持手动分配路由
  7. 自定义拦截器,可以对路由进行拦截,比如登录判断和埋点处理
  8. 自定义路由匹配规则,相比较其他路由框架,该项目并没有限制路由的写法,除了内置的几个匹配器,用户完全可以定义自己的规则
  9. 支持隐式Intent跳转
  10. 支持多模块使用,支持组件化开发
  11. 不仅支持注解Activity,还支持注解Fragment
  12. 支持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

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持呐喊教程。

声明:本文内容来源于网络,版权归原作者所有,内容由互联网用户自发贡献自行上传,本网站不拥有所有权,未作人工编辑处理,也不承担相关法律责任。如果您发现有涉嫌版权的内容,欢迎发送邮件至:notice#nhooo.com(发邮件时,请将#更换为@)进行举报,并提供相关证据,一经查实,本站将立刻删除涉嫌侵权内容。