手记

Android 模块化完整方案实现

Android 模块化完整方案实现

1 模块化实现(module+router)

本套模块化方案实现来源于公司的业务需求,因为公司业务太多,代码越来越臃肿,越来越难维护,为了提升开发效率,减低代码的维护成本,所以采取了模块化开发方案。 
既然是模块化开发,必然要考虑到各个module的开发,调试,迭代拓展及维护,module之间不仅需要做到业务代码隔离,还需要方便的跳转(路由引导模块),方便的传递数据(包括大容量的数据),能够独立编译调。最后,各个module,完成之后,一起打包到主APP即可。

2 本套模块化方案实现特点

  • 支持module单独作为Application编译调试

  • 支持module在debug和release状态下对Application的调用方法完全一致,

  • 支持动态注入路由

  • 支持注解方式注入路由

  • 支持module之间传大容量的数据

  • 路由引导模块:自动生成module之间的跳转调用方法

  • moduleEventBus:实现module之间通信

3 项目代码主体架构设计

4 代码实现方案

4.1 module的apllication实现

我们希望实现以下功能

  • module能单独作为Application编译

  • module有自己的Apllication,并在里面初始化一些第三方SDK服务

  • module在debug和release状态下,业务层代码对application方法调用完全一样

  • module在release状态下,能够调用主App的application

4.1.1 首先gradle配置如下配置

  def isDebug = rootProject.ext.isDebugType
if (isDebug) {
    apply plugin: 'com.android.application'
} else {
    apply plugin: 'com.android.library'
}


这样,在开发时,是一个application,在发布时,是一个library。处于debug状态时,通过 ./gradlew :moduleuser:assemble(mac)命令即可编译打包。

4.1.2 在modulebase中创建ApplicationService

public interface ApplicationService {
    void loadModuleApplicationService(); //初始化一些第三方SDK服务
    Application getApplication(); //获取主APP的Application或者module在debug时自己的application
}


ApplicationService放在moduleBase里面, 无论是主App的Application还是module的application,都要实现ApplicationService接口。

4.1.3 在moduleshop中创建ShopDebugApplication,ShopReleaseApplication和ShopApplication,如图所示:

public class ShopDebugApplication extends Application implements ApplicationService {
...
}

public class ShopReleaseApplication implements ApplicationService {
...
}


为什么需要创建三个Application? 其实代码真正调用的是 ShopApplication,在ShopApplication里面,根据debug或者release状态,去调用ShopDebugApplication或者ShopReleaseApplication的方法,这样就能保证业务层代码对application方法调用完全一致。代码如下:


@Override
    public void loadModuleApplicationService() {
        if (BuildConfig.IS_DEBUG_TYPE) {
            ShopDebugApplication.getInstance().loadModuleApplicationService();
        } else {
            ShopReleaseApplication.getInstance().loadModuleApplicationService();
        }
    }

    @Override
    public Application getApplication() {
        if (BuildConfig.IS_DEBUG_TYPE) {
            return ShopDebugApplication.getInstance().getApplication();
        } else {
            return ShopReleaseApplication.getInstance().getApplication();
        }
    }


ShopDebugApplication是debug调试状态下的Application,ShopReleaseApplication是发布状态的Application。在loadModuleApplicationService方法中,可以初始化一些第三方SDK。 ShopDebugApplication的getApplication() 返回自身实例。 ShopReleaseApplication的getApplication()则通过反射拿到主App的Applicattion。


4.1.4 因为Application需要在library和application之间切换,所以需要配置两套AndroidManifest.xml

gradle配置如下:

if (isDebug) {
    manifest.srcFile 'src/main/debug/AndroidManifest.xml'
} else {
    manifest.srcFile 'src/main/AndroidManifest.xml'
}


4.2 module之间跳转

4.2.1 router实现


通常来讲,module之间可以URL Scheme隐式intent实现跳转,不过这种方式扩展性太差,网上也有很多开源的router框架,比如ARouter,考虑到ARouter相对来说比较重,并且项目需要添加一些更加灵活的功能,比如路由引导模块,大容量数据传递之类的功能,所以就自己实现了一个router模块。 

router实现原理主要是通过拿到需要启动Activity的信息,组装intent再跳转。这里有两种实现方式,编译时注解自动生成路由表和动态注册路由表实现。

1. 动态态注册路由表实现

主要是通过注册activity路由表,启动时,通过路由表拿到待启动的activity的class,组装一个intent,实现跳转


A. 首先在Application或者启动的activity中注册


    Router.registerRouters(new Router.RouterTable() {
        @Override
        public List<Rule> buildRuleList() {
            List<Rule> ruleList = new ArrayList<>();
            ruleList.add(new Rule("user", "main", com.joybar.moduleuser.MainActivity
                    .class));
            ruleList.add(new Rule("shop", "main", com.joybar.moduleshop.MainActivity
                    .class));
        }
    });


B. 简单的启动如下


    Router.create()
            .buildRule(new Rule("shop", "main"))
            .navigate(context);

2. 编译时注解路由实现
  1. 首先自定义编译时注解:@RegisterRouter

  2. 定义注解解释器:编译器会在编译时检查AbstractProcessor的子类,通过创建RouterProcessor并继承AbstractProcessor,在process方法中,主要做两件事:

  • 1.得到@RegisterRouter注解,并解析注解并获取需要的module和path

  • 2.使用JavaFileObject类生成java代码

主要代码如下:


    String module =typeElement.getAnnotation(RegisterRouter.class).module();
    String path = typeElement.getAnnotation(RegisterRouter.class).path();
    String fullName = typeElement.getQualifiedName().toString();
    MethodSpec addRouter = computeAddRouter(Config.ROUTER_MANAGER_METHOD_NAME,module, path, typeElement.getQualifiedName().toString());
    TypeSpec routerManger = TypeSpec.classBuilder(fullName.replace(".", "_") + Config.ROUTER_MANAGER_CLASS_NAME_SUFFIX)
            .addModifiers(Modifier.PUBLIC)
            .addMethod(main)
            .addMethod(addRouter)
            .build();
    JavaFile javaFile = JavaFile.builder(Config.ROUTER_MANAGER_PKN, routerManger)
            .build();
    javaFile.writeTo(mFiler);

3. 路由引导模块实现

这是一个需求性很强烈的功能,主要是方便module之间的调用。比如说同事A定义了一个module A,里面又定义了很多Activity,每个Activty启动时传入的参数又不一样,同事B调用module A时的某个Activity时,在缺乏完整详细文档的情况下,完全无从下手,为了方便module之间的跳转调用,所以实现了一个路由引导模块,能够自动生成module A所有的对其它module公开的调用方法,使用举例如下:

在moduleshop的ReceiveParamActivity中定义了以下两个带有不同参数的启动方法,并声明注解 @RegisterLaunch


    @RegisterLaunch
    public static void launch(Context context,String address){
    ...
    }
     @RegisterLaunch
    public static void launch(Context context,String name,int id){
        ...
        context.startActivity(intent);
    }


声明注解 @RegisterLaunch后,在Builder#main中,执行


public class Builder {

    public static void main(String[] args) {
        CodeMaker.autoGenerateModuleMethodName("moduleshop");
    }
}


在指定的路径下会自动生成以下RouterTable$$Moduleshop类,这个类中,有moduleshop所有的调用方法 


public final class RouterTable$$Moduleshop {

  public static RouterGuider launchReceiveParam(String address) {
    // This class was generated automatically 2017-12-11 20:06:21
    // module=shop,path=receive_param
    RouterGuider routerGuider =  new RouterGuider("shop", "receive_param");
    routerGuider.withString("address", address);
    return routerGuider;
  }

  public static RouterGuider launchReceiveParam(String name, Integer id) {
    // This class was generated automatically 2017-12-11 20:06:21
    // module=shop,path=receive_param
    RouterGuider routerGuider =  new RouterGuider("shop", "receive_param");
    routerGuider.withString("name", name);
    routerGuider.withInt("id", id);
    return routerGuider;
  }
}



这样,其它module的开发同事就能直接调用RouterTable$$Moduleshop.launchReceiveParam("obo", 25).navigate(context)或者launchReceiveParam("杭州"),就能启动moduleshop的ReceiveParamActivity并传入对应参数了。 
自动生成路由引导模块的原理也很简单,根据注解@RegisterRouter拿到Activity 类相应的信息,通过 @RegisterLaunch拿到相关的启动参数信息,再通过javapoet,在指定路径下生成相关的类和方法,具体实现这里就不赘述了,详见源码

4. module之间大容量数据传递

Activity之间传递数据通常是使用Bundle,但是Bundle传递数据时是有大小限制的。主要是通过注解@DataParam,通过解析注解将大容量对象保存到一个静态map集合中,然后通过反射把大容量对象传入其它module

5. module之间通讯

在同一进程间通信,EventBus无意非常流行,因为嫌弃EventBus太重,所以就实现了一个简单的moduleEventbus,其实现原理完全照搬EventBus,其使用方法和EventBus也完全一致,分为 定义事件类型,订阅,发布事件,订阅事件处理,解除订阅几个步骤,不过核心代码精简到100多行,具体实现详见代码

4.3 资源名冲突

通过设置resourcePrefix即可解决 


if (!isDebug) {
            resourcePrefix 'user_'
        }



最终的代码结构图:


各个module完成之后,正常打包即可发布。值得一提的是,module之间的拆分颗粒度不可过细或者过粗。过细会导致module太多,过粗则违背了模块化开发的初衷。所以,在一开始拆分module时,一定要先理清项目的业务,对于一些公用的业务模块,可以放到业务基础组件中,module拆分也不可能一蹴而就,需要随着业务需求不断的优化调整。 

原文链接:http://www.apkbus.com/blog-873057-77490.html

0人推荐
随时随地看视频
慕课网APP