Android彻底组件化—UI跳转升级改造

得到Android组件化方案已经开源,参见Android组件化方案开源。方案的解读文章是一个小的系列,这是系列的第四篇文章:
1、Android彻底组件化方案实践
2、Android彻底组件化demo发布
3、Android彻底组件化-代码和资源隔离
4、Android彻底组件化—UI跳转升级改造
5、Android彻底组件化—如何使用Arouter

JIMU开源以后,收到了很多朋友的评论或者私信,提出了很多有价值的意见和建议,一个比较集中的点就在于组件之间的UI跳转不够优雅。当时由于业务比较紧张,没有时间来完善这块,最近终于抽出时间把UI跳转的功能进行了升级改造,期间也得到@leobert等大牛的鼎力支持以及ARouter等优秀方案的启发,现在JIMU新的UI跳转功能已经发布了,欢迎大家使用。

已实现功能

(1)按组件区分host,增加URL的可读性
(2)自动注册路由,不再需要手动编写代码进行路由分发
(3)按需加载,只有实际跳转到某个组件是,该组件的路由表才会加载
(4)自动生成路由表文件,方便组件开发团队之间调用
(5)参数支持依赖注入,不需要编写参数的解析代码

URL结构

组件之间的UI跳转是基于标准的URL来实现的,先简单看一下URL的基本构成:

:///?

这个是最简单的一个模型,不过用于我们UI跳转协议已经足够了。下面是一个跳转到分享页面的实例:

DDComp://share/shareBook?bookName=Gone with the Wind

结合我们的组件化框架,我们简单讲一下各部分的含义

(1)scheme对应的是DDComp,这个在JIMU没有限制,使用时可以自己自由设置,一般为了从应用外跳转进来,会在manifest的入口Activity添加以下配置


    
    
    
    
    

(2)host对应的是share。在组件化框架中,每个组件对应一个唯一的host,例如分享组件的host就是share,读书组件的host是reader等等。
● host是路由分发的第一级,根据host可以定位到每个组件。
● host还可以对所有的路由URL进行一个分组,只有调用到该分组的路由的时候,组内的路由才会被加载进内存

(3)path对应的是shareBook。它对应的是具体的每个具体的页面,例如shareBook对应就是ShareActivity。在一个组件之内,path是不能重复的

(4)query对应的是bookName=Gone with the Wind。它表示要跳转到ShareActivity,需要传入的参数,例如这里需要传入书的名字等。

下面我们就讲一下如何使用JIMU的UI跳转新功能!

组件添加必要的依赖

在组件的build.gradle中添加依赖

annotationProcessor 'com.luojilab.ddcomponent:router-anno-compiler:1.0.0'

同时添加

defaultConfig {
    javaCompileOptions {
        annotationProcessorOptions {
             arguments = [host: "share"]
        }
    }
}

此处的"share"是跳转URI中的host,每个组件需要设置不同的host。

注册组件到UIRouter中

在组件的声明周期类ApplicationLike中,添加注册和反注册代码

public class ShareApplike implements IApplicationLike {
    UIRouter uiRouter = UIRouter.getInstance();
    @Override
    public void onCreate() {
        uiRouter.registerUI("share");
    }
    @Override
    public void onStop() {
        uiRouter.unregisterUI("share");
    }
}

目标页面添加注解

首先在跳转的目的Activity上添加RouteNode注解

@RouteNode(path = "/shareBook", desc = "分享书籍页面")
public class ShareActivity extends AppCompatActivity {

如果需要传入参数,在具体的参数定义上增加Autowired注解:

@Autowired
String bookName;
@Autowired
Author author;

注意此处的参数不能是private的,否则编译会直接报错。这里的原因在于依赖注入的时候没有使用反射,而是直接调用了该参数,所以需要参数至少是包可见的。

依赖注入

如果想使用自动装载功能,需要在Activity的onCreate中调用方法

AutowiredService.Factory.getInstance().create().autowire(this);

建议该方法在基类Activity中调用

build项目

项目执行build,会生成apt文件,具体可在build目录下面查看
同时还会在根目录生成UIRouterTable文件夹,里面会列出每个组件向外提供的路由表

auto generated, do not change !!!! 

HOST : share

分享杂志页面
/shareMagazine
author:com.luojilab.componentservice.share.bean.Author
bookName:String

分享书籍页面
/shareBook
author:com.luojilab.componentservice.share.bean.Author
bookName:String

跳转

在发起跳转页面,有三种方式可以跳转到目的页面

Bundle方式
    // UI transfer with Bundle
    private void goToShareActivityWithBundle() {
        Author author = new Author();
        author.setName("Margaret Mitchell");
        author.setCounty("USA");
        Bundle bundle = new Bundle();
        bundle.putString("bookName", "Gone with the Wind");
        bundle.putString("author", JsonService.Factory.getInstance()
                .create().toJsonString(author));
        UIRouter.getInstance().openUri(getActivity(), "DDComp://share/shareBook", bundle);
    }
URI方式
    // UI transfer with URI
    private void goToShareActivityWithUri() {
        Author author = new Author();
        author.setName("Barack Obama");
        author.setCounty("New York");
        final String URI_LEGAL = "DDComp://share/shareMagazine?bookName=NYTIME&author=";
        legal and illegal data delivering*/
        UIRouter.getInstance().openUri(getActivity(),
                URI_LEGAL
                        + JsonService.Factory.getInstance().create().toJsonString(author), null);
    }
startActivityForResult
    //startActivityForResult
    private void goToShareActivityForResult() {
        Author author = new Author();
        author.setName("Margaret Mitchell");
        author.setCounty("USA");
        UIRouter.getInstance().openUri(getActivity(),
                "DDComp://share/shareBook?bookName=Gone with the Wind&author="
                        + JsonService.Factory.getInstance().create().toJsonString(author), null, 7777);
    }

具体使用请参见github源码 https://github.com/mqzhangw/AndroidComponent。如果对方案有不理解的地方,欢迎阅读解析文章Android彻底组件化方案实践和Android彻底组件化demo发布

目前很多app已经使用ARouter来进行UI跳转,JIMU也是支持ARouter的,只是为了更契合现在的组件化框架,所以自己实现了一套。鉴于已使用ARouter的app迁移成本有点高,后面会专门写一篇如何在组件化框架中使用ARouter的文章,敬请期待!

JIMU的讨论群,群号693097923,欢迎大家加入:


Android彻底组件化—UI跳转升级改造_第1张图片
进群请扫码

你可能感兴趣的:(Android彻底组件化—UI跳转升级改造)