TheRouter Android 组件化改造框架使用教程

gitblog_00881

于 2024-09-14 09:36:05 发布

阅读量383

点赞数 3

本文链接：https://blog.csdn.net/gitblog_00881/article/details/142249701

版权

TheRouter Android 组件化改造框架使用教程

hll-wp-therouter-android A framework for assisting in the renovation of Android componentization(帮助 App 进行组件化改造的动态路由框架) 项目地址: https://gitcode.com/gh_mirrors/hl/hll-wp-therouter-android

1. 项目介绍

TheRouter 是一个帮助 Android 应用进行组件化改造的动态路由框架。它提供了四大核心功能：

页面导航跳转能力（Navigator）：支持页面之间的跳转和参数传递。
跨模块依赖注入能力（ServiceProvider）：支持跨模块的依赖注入，简化模块间的耦合。
单模块自动初始化能力（FlowTaskExecutor）：自动初始化模块，减少手动初始化的工作量。
远程方法动态加载能力（ActionManager）：支持客户端应用远程加载方法，增强应用的灵活性。

TheRouter 旨在简化 Android 应用的组件化改造过程，提高开发效率和代码的可维护性。

2. 项目快速启动

2.1 Gradle 配置

在项目的 build.gradle 文件中添加以下配置：

// root build.gradle
classpath 'cn.therouter:plugin:1.2.2'

// app module
apply plugin: 'therouter'

dependencies {
    kapt "cn.therouter:apt:1.2.2"
    implementation "cn.therouter:router:1.2.2"
}

2.2 初始化库

在应用的 attachBaseContext 方法中进行初始化：

@Override
protected void attachBaseContext(Context base) {
    TheRouter.setDebug(true); // 设置 Debug 环境
    super.attachBaseContext(base);
}

2.3 页面参数注入

在 Activity 或 Fragment 的 onCreate 方法中进行参数注入：

@Override
protected void onCreate(@Nullable Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    TheRouter.inject(this);
}

2.4 页面导航

使用 @Route 注解进行页面导航：

@Route(path = "http://therouter.com/home", action = "action://scheme.com", description = "second page", params = ["hello", "world"])
public class HomeActivity extends BaseActivity {
    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        TheRouter.build("Path")
            .withInt("intValue", 12345678)
            .withString("str_123_Value", "传中文字符串")
            .withBoolean("boolValue", true)
            .withLong("longValue", 123456789012345L)
            .withChar("charValue", 'c')
            .withDouble("double", 3.14159265358972)
            .withFloat("floatValue", 3.14159265358972F)
            .navigation();
    }
}