Android简易路由框架：EasyRouter轻松构建模块化应用

Android

2023-10-27 20:01:03

一、EasyRouter简介

EasyRouter是一个专为Android开发的轻量级路由框架。它基于Android的Intent机制，通过统一的路由规则和灵活的路由配置，可以轻松实现应用各组件之间的跳转，简化了应用的开发和维护。

EasyRouter框架主要包含三大模块功能：路由转发、自动注入和路由拦截。路由转发模块负责将路由请求转发到相应的组件；自动注入模块负责将路由组件中声明的依赖项自动注入到组件中；路由拦截模块负责对路由请求进行拦截和处理。

二、EasyRouter特点

轻量级： EasyRouter框架非常轻量级，不会对应用的性能造成明显的影响。
简单易用： EasyRouter框架使用简单，易于上手，不需要复杂的配置和学习。
功能全面： EasyRouter框架的功能非常全面，包括路由转发、自动注入和路由拦截等，可以满足大多数应用的路由需求。
可扩展性强： EasyRouter框架的可扩展性很强，可以轻松集成其他第三方库，满足不同的应用需求。

三、EasyRouter使用指南

1. 集成EasyRouter框架

dependencies {
    implementation 'com.github.getActivity:EasyRouter:1.6.0'
}

2. 初始化EasyRouter框架

EasyRouter.init(this);

3. 定义路由规则

在应用程序的AndroidManifest.xml文件中定义路由规则。

<manifest ... >
    <application ... >
        <activity
            android:name=".MainActivity"
            android:label="@string/app_name">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
            <meta-data
                android:name="ERouter"
                android:value="activity" />
        </activity>

        <activity
            android:name=".SecondActivity"
            android:label="@string/title_second_activity">
            <meta-data
                android:name="ERouter"
                android:value="second" />
        </activity>
    </application>
</manifest>

4. 使用EasyRouter框架进行路由跳转

// 通过路由路径跳转到SecondActivity
EasyRouter.getInstance().build("/second").navigation();

// 通过路由路径和参数跳转到SecondActivity
EasyRouter.getInstance().build("/second")
    .withString("name", "张三")
    .withInt("age", 20)
    .navigation();

5. 使用EasyRouter框架进行自动注入

在路由组件中声明需要自动注入的依赖项。

public class SecondActivity extends Activity {

    @BindView(R.id.tv_name)
    TextView tvName;

    @BindView(R.id.tv_age)
    TextView tvAge;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_second);
        EasyRouter.getInstance().inject(this);

        // 获取通过路由传递的参数
        String name = getIntent().getStringExtra("name");
        int age = getIntent().getIntExtra("age", 0);

        // 设置TextView的值
        tvName.setText(name);
        tvAge.setText(String.valueOf(age));
    }
}

6. 使用EasyRouter框架进行路由拦截

在应用程序中注册路由拦截器。

EasyRouter.getInstance().addInterceptor(new MyRouterInterceptor());

在路由拦截器中拦截路由请求。

public class MyRouterInterceptor implements IRouteInterceptor {

    @Override
    public boolean intercept(RouteRequest request) {
        // 判断是否需要拦截路由请求
        if (request.getPath().equals("/second")) {
            // 拦截路由请求，并跳转到另一个页面
            EasyRouter.getInstance().build("/third").navigation();
            return true;
        }

        // 不拦截路由请求
        return false;
    }
}

四、EasyRouter框架示例

以下是一个使用EasyRouter框架构建的简单示例。

MainActivity.java

public class MainActivity extends Activity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        // 通过路由路径跳转到SecondActivity
        EasyRouter.getInstance().build("/second")
            .withString("name", "张三")
            .withInt("age", 20)
            .navigation();
    }
}

SecondActivity.java

public class SecondActivity extends Activity {

    @BindView(R.id.tv_name)
    TextView tvName;

    @BindView(R.id.tv_age)
    TextView tvAge;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_second);
        EasyRouter.getInstance().inject(this);

        // 获取通过路由传递的参数
        String name = getIntent().getStringExtra("name");
        int age = getIntent().getIntExtra("age", 0);

        // 设置TextView的值
        tvName.setText(name);
        tvAge.setText(String.valueOf(age));
    }
}