确认过眼神，这就是你要的路由库

2018-05-30 本文已影响0人未来的理想

上一篇文章我们谈到了如何实现一个路由库，那本篇文章就给大家推荐一个好用的路由库，来确认下眼神，这就是你要的路由库。

EasyRouter：一个简单、稳定、强大、高性能的组件化路由框架。github地址：https://github.com/liuzhao2007/EasyRouter。

欢迎使用、star、fork、pr。

image

一、功能特性

通过url打开Activity，实现界面间解耦；
通过服务实现方法调用，实现Module间方法调用解耦；
通过拦截器实现界面跳转的处理：条件拦截、埋点统计等；
界面、服务、拦截器均支持多Module；
基于编译时注解，界面、服务、拦截器等均可自动注册；
可传递Bundle支持的所有数据类型；
支持自动注入参数到目标界面；
支持获取Fragment；
支持全局、局部过程监听：降级、打开后等；
Api简单、实现高性能；

image

二、应用场景

Module内、跨Module界面跳转，界面解耦；
界面跳转过程拦截：条件拦截（eg：未登录）、重定向等；
跨Module方法调用，Module间解耦；
外部Url跳转应用内界面；

三、集成使用

1. 添加依赖与配置

    android {
        defaultConfig {
            javaCompileOptions {
                annotationProcessorOptions {
                    arguments = [ moduleName : project.getName() ]
                }
            }
        }
    }

    dependencies {
        compile 'com.easyrouter:router-api:1.2.3'
        compile 'com.easyrouter:router-annotation:1.2.3'
        annotationProcessor 'com.easyrouter:router-compiler:1.2.3'
    }

在Project级别的build.gradle中添加：

    allprojects {
        repositories {
            jcenter()
            maven { url "https://dl.bintray.com/liuzhaowy2007/maven" }
        }
    }

2、初始化

EasyRouterConfig.getInstance().setScheme()必调，别的设置选调；

    EasyRouterConfig.getInstance()
            .setDebug(true)
            .setScheme("easyrouter")
            .setDefaultRouterCallBack(new IRouterCallBack() {
                @Override
                public void onFound() {
                    LogUtil.i("default onFound");
                }

                @Override
                public void onLost() {
                    LogUtil.i("default onLost");
                }

                @Override
                public void onOpenSuccess() {
                    LogUtil.i("default onOpenSuccess");
                }

                @Override
                public void onOpenFailed() {
                    LogUtil.i("default onOpenFailed");
                }
            })
            .init(EasyRouterApp.this);

3、添加注解

在app里任意一个类中添加注解@DispatcherModules，里面写上所有使用此框架的Module的name；

    例如：@DispatcherModules({"app","moduleinteract"})；

在任意需要路由打开的Activity加上注解@DisPatcher，里面写上其对应的url；

    @DisPatcher({"easyrouter://main", "easyrouter://maintwo"})
    public class MainActivity extends Activity

4、发起路由

    1. EasyRouter.open("easyrouter://main");//方式一
    2. EasyRouter.with("easyrouter://main").open();//方式二

四、进阶使用

1、传递参数

不通过url传参；

    EasyRouter.with("easyrouter://main").withString("stringparams","")// 传递基本数据类型；
                        .withParcelable("parcelable",null)// 传递系列化对象；
                        .withFlags(Intent.FLAG_ACTIVITY_NEW_TASK)// 设置Flag；
                        .withTransition(0,0)// 设置动画；
                        .open(Activity,requestCode);// 设置RequestCode

通过url传参：非必须参数；

    EasyRouter.open("easyrouter://main?name=liuzhao&sex=man");
    这样传递了两个参数：name与sex；在目标Activity中可以通过getIntent.getString("name")方式来获取；

通过url传参：必须参数；

    注解声明：
    @DisPatcher({"easyrouter://main/i:tab"}) // 注解声明需要一个必备参数tab，并且声明其类型为int；
    public class MainActivity extends Activity 

    调用：
    EasyRouter.open("easyrouter://main/3");
    这样传递了一个参数：tab；在目标Activity中可以通过getIntent.getInt("tab",0)方式来获取；

备注：必须参数与非必须参数可搭配使用，区别在于必须参数参与url匹配过程；通过url传参与不通过url传参两种方式可搭配使用。

2、Module间通信（方法调用）

配置稍微复杂，但使用极其简单；可参考modulelib中的BaseModuleService。

在项目的Library中创建继承IBaseModuleService的接口文件com.android.easyrouter.service.BaseModuleService；（包名、类名及继承关系不可变）
各Module需要向外提供的方法在BaseModuleService中新建接口类并暴露接口；

  public interface ModuleInteractService extends BaseModuleService {
      void runModuleInteract(Context context);
  }

在Module中创建Module的接口实现类，类名需要和接口名一样；
打上注解@ModuleService、并编译；
在别的Module中直接以方法调用；

  EasyRouter.getModuleService(BaseModuleService.ModuleInteractService.class).runModuleInteract(context);

备注：配置复杂带来的优势是方法的直接调用，无需强转也不限定调用方法的方法签名；

3、拦截器

实现IInterceptor接口；
打上注解@Interceptor；

    @Interceptor
    public class RouterTestInterceptor implements IInterceptor{

        @Override
        public boolean intercept() {
            LogUtil.i("intercept by me");
            return true;// if true intercept; false go on;
        }

        @Override
        public void onIntercepted() {
        }
    }

备注：在intercept方法中进行拦截与否的判断，例如登录态、重定向等；

4、过程监听

  EasyRouter.open("easyrouter://routertest",new IRouterCallBack(){
        @Override
        public void onFound() {
            //匹配到
        }

        @Override
        public void onLost() {
            //匹配不到，可做降级；
        }

        @Override
        public void onOpenSuccess() {
            //界面打开成功
        }

        @Override
        public void onOpenFailed() {
            //界面打开失败，可做降级；
        }
    });

备注：可以对每一次路由做监听，也可以设置全局默认的监听；

    EasyRouter.init(EasyRouterApp.this).setScheme("easyrouter").setDefaultRouterCallBack();

5、获取Fragment；

    // 传入Fragment继承的类，android.app.Fragment或者android.support.v4.app.Fragment
    Fragment fragment = EasyRouter.with("easyrouter://fragmenttest").getFragment(Fragment.class);

6、外部Url跳转应用内界面；

AndroidManifest.xml中注册

    <activity
        android:name="com.android.easyrouter.url.EasyRouterUrlActivity"
        android:theme="@android:style/Theme.Translucent.NoTitleBar">
        <intent-filter>
            <action android:name="android.intent.action.VIEW" />
            <category android:name="android.intent.category.DEFAULT" />
            <category android:name="android.intent.category.BROWSABLE" />
            <data android:scheme="easyrouter" /><!--改成自己的Scheme-->
        </intent-filter>
    </activity>

备注：也可以使用自己的Activity：

只需要调用EasyRouter.open(Uri.toString());即可

7、自动注入参数到界面；

在目标Activity中加上EasyRouter.inject(this);
在Activity中需要自动传参的参数上加上注解@AutoAssign，则会自动通过Intent赋值。例如：

    @AutoAssign
    long time;
    @AutoAssign
    int age;
    @AutoAssign
    String url;

备注：自动注入参数功能目前仅支持基本数据类型和String；

广告时间

今日头条各Android客户端团队招人火爆进行中，各个级别和应届实习生都需要，业务增长快、日活高、挑战大、待遇给力，各位大佬走过路过千万不要错过！

本科以上学历、非频繁跳槽（如两年两跳），欢迎加我的微信详聊：KOBE8242011

欢迎关注