关于Android模块化我有一些话不知当讲不当讲

移动开发 Android
最近公司一个项目使用了模块化设计,本人参与其中的一个小模块开发,但是整体的设计并不是我架构设计的,开发半年有余,在此记录下来我的想法。

最近公司一个项目使用了模块化设计,本人参与其中的一个小模块开发,但是整体的设计并不是我架构设计的,开发半年有余,在此记录下来我的想法。

[TOC]

模块化场景

为什么需要模块化?

当一个App用户量增多,业务量增长以后,就会有很多开发工程师参与同一个项目,人员增加了,原先小团队的开发方式已经不合适了。

原先的一份代码,现在需要多个人来维护,每个人的代码质量也不相同,在进行代码Review的时候,也是比较困难的,同时也容易会产生代码冲突的问题。

同时随着业务的增多,代码变的越来越复杂,每个模块之间的代码耦合变得越来越严重,解耦问题急需解决,同时编译时间也会越来越长。

人员增多,每个业务的组件各自实现一套,导致同一个App的UI风格不一样,技术实现也不一样,团队技术无法得到沉淀。

架构演变

在刚刚开始的时候,项目架构使用的是MVP模式,这也是最近几年很流行的一个架构方式,下面是项目的原始设计。

关于Android模块化我有一些话不知当讲不当讲

随着业务的增多,我们添加了Domain的概念,Domain从Data中获取数据,Data可能会是Net,File,Cache各种IO等,然后项目架构变成了这样。

关于Android模块化我有一些话不知当讲不当讲

再然后随着人员增多,各种基础组件也变的越来越多,业务也很复杂,业务与业务之间还有很强的耦合,就变成了这样的。

关于Android模块化我有一些话不知当讲不当讲

使用模块化技术以后,架构变成了这样。

关于Android模块化我有一些话不知当讲不当讲

 

 

技术要点

这里简单介绍下Android项目实现模块化需要使用的技术以及技术难点。

Library module

在开始开始进行模块化之前,需要把各个业务单独抽取成Android Library Module,这个是Android Studio自带一个功能,可以把依赖较少的,作为基本组件的抽取成一个单独模块。

如图所示,我把各个模块单独分为一个独立的项目。

关于Android模块化我有一些话不知当讲不当讲

在主项目中使用gradle添加代码依赖。

 

  1. // common 
  2.     compile project(':ModuleBase'
  3.     compile project(':ModuleComponent'
  4.     compile project(':ModuleService'
  5.  
  6.     // biz 
  7.     compile project(':ModuleUser'
  8.     compile project(':ModuleOrder'
  9.     compile project(':ModuleShopping'

Library module开发问题

在把代码抽取到各个单独的Library Module中,会遇到各种问题。最常见的就是R文件问题,Android开发中,各个资源文件都是放在res目录中,在编译过程中,会生成R.java文件。R文件中包含有各个资源文件对应的id,这个id是静态常量,但是在Library Module中,这个id不是静态常量,那么在开发时候就要避开这样的问题。

举个常见的例子,同一个方法处理多个view的点击事件,有时候会使用 switch(view.getId()) 这样的方式,然后用 case R.id.btnLogin 这样进行判断,这时候就会出现问题,因为id不是经常常量,那么这种方式就用不了。

同样开发时候,用的最多的一个第三方库就是ButterKnife,ButterKnife也是不可以用的,在使用ButterKnife的时候,需要用到注解配置一个id来找到对应view,或者绑定对应的各种事件处理,但是注解中的各个字段的赋值也是需要静态常量,那么就不能够使用ButterKnife了。

解决方案有下面几种:

  1. 重新一个Gradle插件,生成一个R2.java文件,这个文件中各个id都是静态常量,这样就可以正常使用了。
  2. 使用Android系统提供的最原始的方式,直接用 findViewById 以及 setOnClickListener 方式。
  3. 设置项目支持Databinding,然后使用Binding中的对象,但是会增加不少方法数,同时Databinding也会有编译问题和学习成本,但是这些也是小问题,个人觉的问题不大。

上面是主流的解决方法,个人推荐的使用优先级为 3 > 2 > 1。

当把个模块分开以后,每个人就可以单独分组对应的模块就行了,不过会有资源冲突问题,个人建议是对各个模块的资源名字添加前缀,比如user模块中的登录界面布局为 activity_login.xml ,那么可以写成这样 us_activity_login.xml 。这样就可以避免资源冲突问题。同时Gradle也提供的一个字段 resourcePrefix ,确保各个资源名字正确,具体用法可以参考官方文档。

依赖管理

当完成了Library module后,代码基本上已经很清晰了,跟我们上面的最终架构已经很相似了,有了最基本的骨架,但是还是没有完成,因为还是多个人操作同一个git仓库,各个开发小伙伴还是需要对同一个仓库进行各种fork和pr。

随着对代码的分割,但是主项目app的依赖变多了,如果修改了lib中的代码,那么编译时间是很恐怖的,大概统计了一下,原先在同一个模块的时候,编译时间大概需要2-3min,但是分开以后大概需要5-6min,这个是绝对无法忍受的。

上面的***问题,可以这样解决,把各个子module分别使用单独的一个git仓库,这样每个人也只需要关注自己需要的git仓库即可,主仓库使用git submodule的方式,分别依赖各个子模块。

但是这样还是无法解决编译时间过长的问题,我们把各个模块也单独打包,每次子模块开发完成以后,发布到maven仓库中,然后在主项目中使用版本进行依赖。

举个例子,比如进行某一版本迭代,这个版本叫1.0.0,那么各个模块的版本也叫同样的版本,当版本完成测试发布后,对各个模块打对应版本的tag,然后就很清楚的了解各模块的代码分布。

gradle依赖如下。

 

  1. // common 
  2.     compile 'cn.mycommons:base:1.0.0' 
  3.     compile 'cn.mycommons:component:1.0.0' 
  4.     compile 'cn.mycommons:service:1.0.0' 
  5.  
  6.     // biz 
  7.     compile 'cn.mycommons:user:1.0.0' 
  8.     compile 'cn.mycommons:order:1.0.0' 
  9.     compile 'cn.mycommons:shopping:1.0.0' 

可能有人会问,既然各个模块已经分开开发,那么如果进行开发联调,别急,这个问题暂时保留,后面会对这个问题后面再表。

数据通信

当一个大项目拆成若干小项目时候,调用的姿势发生了少许改变。我这边总结了App各个模块之间的数据通信几种方式。

  • 页面跳转,比如在订单页面下单时候,需要判断用户是否登录,如果没有则需要跳到登录界面。
  • 主动获取数据,比如在下单时候,用户已经登录,下单需要传递用户的基本信息。
  • 被动获得数据,比如在切换用户的时候,有时候需要更新数据,如订单页面,需要把原先用户的购物车数据给清空。

再来看下App的架构。

关于Android模块化我有一些话不知当讲不当讲

***个问题,原先的方式,直接指定某个页面的ActivityClass,然后通过intent跳转即可,但是在新的架构中,由于shopping模块不直接依赖user,那么则不能使用原始的进行跳转,我们解决方式使用Router路由跳转。

第二个问题,原先的方式有个专门的业务单利,比如UserManager,直接可以调用即可,同样由于依赖发生了改变,不能够进行调用。解决方案是所有的需要的操作,定义成接口放在Service中。

第三个问题,原先的方式,可以针对事件变化提供回调接口,当我需要监听某个事件时候,设置回调即可。

页面路由跳转

如上分析,原先方式代码如下。

 

  1. Intent intent = new Intent(this, UserActivity.class); 
  2.     startActivity(intent); 

但是使用Router后,调用方式改变了。

  1. RouterHelper.dispatch(getContext(), "app://user"); 

具体的原理是什么,很简单的,做一个简单的映射匹配即可,把 "app://user" 与 UserActivity.class 配对,具体的就是定义一个Map,key是对应的Router字符,value是Activity的class。在跳转时候从map中获取对应的ActivityClass,然后在使用原始的方式。

可能有人的会问,要向另外一个页面传递参数怎么办,没事我们可以在router后面直接添加参数,如果是一个复杂的对象那么可以把对象序列化成json字符串,然后再从对应的页面通过反序列化的方式,得到对应的对象。

例如:

  1. RouterHelper.dispatch(getContext(), "app://user?id=123&obj={"name":"admin"}"); 

注:上面的router中json字符串是需要url编码的,不然会有问题的,这里只是做个示例。

除了使用Router进行跳转外,我想了一下,可以参考Retrofit方式,直接定义跳转Java接口,如果需要传递额外参数,则以函数参数的方式定义。

这个Java接口是没有实现类的,可以使用动态代理方式,然后接下来的方式,和使用Router的方式一样。

那么这总两种方式有什么优缺点呢。

Router方式:

  • 有点:不需要高难度的技术点,使用方便,直接使用字符串定义跳转,可以好的往后兼容
  • 缺点:因为使用的是字符串配置,如果字符输入字符,则很难发现bug,同时也很难知道某个参数对应的含义

仿Retrofit方式:

  • 因为是Java接口定义,所以可以很简单找到对应的跳转方法,参数定义也很明确,可以直接写在接口定义处,方便查阅。
  • 同样因为是Java接口定义,那么如果需要扩展参数,只能重新定义新方法,这样会出现多个方法重载,如果在原先接口上修改,对应的原先调用方也要做响应的修改,比较麻烦。

上面是两种实现方式,如果有相应同学要实现模块化,可以根据实际情况做出选择。

Interface和Implement

如上分析,如果需要从某个业务中获取数据,我们分别需要定义接口以及实现类,然在获取的时候在通过反射来实例化对象。

下面是简单的代码示例

接口定义

 

  1. public interface IUserService { 
  2.  
  3.     String getUserName(); 

实现类

 

  1. class UserServiceImpl implements IUserService { 
  2.  
  3.     @Override 
  4.     public String getUserName() { 
  5.         return "UserServiceImpl.getUserName"
  6.     } 

反射生成对象

 

  1. public class InjectHelper { 
  2.  
  3.     @NonNull 
  4.     public static AppContext getAppContext() { 
  5.         return AppContext.getAppContext(); 
  6.     } 
  7.  
  8.     @NonNull 
  9.     public static IModuleConfig getIModuleConfig() { 
  10.         return getAppContext().getModuleConfig(); 
  11.     } 
  12.  
  13.     @Nullable 
  14.     public static <T> T getInstance(Class<T> tClass) { 
  15.         IModuleConfig config = getIModuleConfig(); 
  16.         Class<? extends T> implementClass = config.getServiceImplementClass(tClass); 
  17.         if (implementClass != null) { 
  18.             try { 
  19.                 return implementClass.newInstance(); 
  20.             } catch (Exception e) { 
  21.                 e.printStackTrace(); 
  22.             } 
  23.         } 
  24.         return null
  25.     } 

实际调用

 

  1. IUserService userService = InjectHelper.getInstance(IUserService.class); 
  2.     if (userService != null) { 
  3.         Toast.makeText(getContext(), userService.getUserName(), Toast.LENGTH_SHORT).show(); 
  4.     } 

本示例中每次调用都是用反射生成新的对象,实际应用中可能与IoC工具结合使用,比如Dagger2.

EventBus

针对上面的第三个问题,原先设计的使用方式也是可以的,只需要把回调接口定义到对应的service接口中,然后调用方就可以使用。

但是我建议可以使用另外一个方式——EventBus,EventBus也是利用观察者模式,对事件进行监听,是设置回调更优雅方式的实现。

优点:不需要定义很多个回调接口,只需要定义事件Class,然后通过Claas的唯一性来进行事件匹配。

缺点:需要定义很多额外的类来表示事件,同时也需要关注EventBus的生命周期,在不需要使用事件时候,需要注销事件绑定,不然容易发生内存泄漏。

映射匹配

上面的介绍的各个模块之间通信,都运涉及到映射匹配问题,在此我总结了一下,主要涉及到一下三种方式。

Map register

Map register是这样的,全局定义一个Map,各个模块在初始化的时候,分别在初始化的时候注册映射关系。

下面是简单的代码示例,比如我们定义一个模块生命周期,用于初始化各个模块。

 

  1. public interface IModuleLifeCycle { 
  2.  
  3.     void onCreate(IModuleConfig config); 
  4.  
  5.     void onTerminate(); 

User模块初始化

 

  1. public class UserModuleLifeCycle extends SimpleModuleLifeCycle { 
  2.  
  3.     public UserModuleLifeCycle(@NonNull Application application) { 
  4.         super(application); 
  5.     } 
  6.  
  7.     @Override 
  8.     public void onCreate(@NonNull IModuleConfig config) { 
  9.         config.registerService(IUserService.class, UserServiceImpl.class); 
  10.         config.registerRouter("app://user", UserActivity.class); 
  11.     } 

在Application中完成初始化

 

  1. public class AppContext extends Application { 
  2.  
  3.     private ModuleLifeCycleManager lifeCycleManager; 
  4.  
  5.     @Override 
  6.     public void onCreate() { 
  7.         super.onCreate(); 
  8.  
  9.         lifeCycleManager = new ModuleLifeCycleManager(this); 
  10.         lifeCycleManager.onCreate(); 
  11.     } 
  12.  
  13.     @Override 
  14.     public void onTerminate() { 
  15.         super.onTerminate(); 
  16.  
  17.         lifeCycleManager.onTerminate(); 
  18.     } 
  19.  
  20.     @NonNull 
  21.     public IModuleConfig getModuleConfig() { 
  22.         return lifeCycleManager.getModuleConfig(); 
  23.     } 
  24.  
  25. public class ModuleLifeCycleManager { 
  26.  
  27.     @NonNull 
  28.     private ModuleConfig moduleConfig; 
  29.     @NonNull 
  30.     private final List<IModuleLifeCycle> moduleLifeCycleList; 
  31.  
  32.     ModuleLifeCycleManager(@NonNull Application application) { 
  33.         moduleConfig = new ModuleConfig(); 
  34.         moduleLifeCycleList = new ArrayList<>(); 
  35.         moduleLifeCycleList.add(new UserModuleLifeCycle(application)); 
  36.         moduleLifeCycleList.add(new OrderModuleLifeCycle(application)); 
  37.         moduleLifeCycleList.add(new ShoppingModuleLifeCycle(application)); 
  38.     } 
  39.  
  40.     void onCreate() { 
  41.         for (IModuleLifeCycle lifeCycle : moduleLifeCycleList) { 
  42.             lifeCycle.onCreate(moduleConfig); 
  43.         } 
  44.     } 
  45.  
  46.     void onTerminate() { 
  47.         for (IModuleLifeCycle lifeCycle : moduleLifeCycleList) { 
  48.             lifeCycle.onTerminate(); 
  49.         } 
  50.     } 
  51.  
  52.     @NonNull 
  53.     IModuleConfig getModuleConfig() { 
  54.         return moduleConfig; 
  55.     } 

APT

使用注解的方式配置映射信息,然后生成一个类似Database一样的文件,然后Database文件中包含一个Map字段,Map中记录各个映射信息。

首先需要定义个Annotation。

如:

 

  1. @Target(ElementType.TYPE) 
  2. @Retention(RetentionPolicy.CLASS) 
  3. public @interface Implements { 
  4.  
  5.     Class parent(); 

需要实现一个 Annotation Process Tool,来解析自己定义的Annotation。

代码略,此代码有点复杂,暂时不贴了。

编译产生的文件,大概如下所示。

 

  1. public class Implement_$$_Database { 
  2.  
  3.     @NonNull 
  4.     private final Map<Class<?>, Class<?>> serviceConfig; 
  5.  
  6.     public Implement_$$_Database() { 
  7.  
  8.         serviceConfig = new HashMap<>(); 
  9.         serviceConfig.put(IUserService.class, UserServiceImpl.class); 
  10.     } 
  11.  
  12.     public <T> Class<? extends T> getServiceImplementClass(Class<T> serviceClass) { 
  13.         return (Class<? extends T>) serviceConfig.get(serviceClass); 
  14.     } 

然后利用反射找到 Implement_$$_Database 这个类,然后从方法中找到配对。

 

  1. public class InjectHelper { 
  2.  
  3.     @Nullable 
  4.     public static <T> T getInstanceByDatabase(Class<T> tClass) { 
  5.         Implement_$$_Database database = new Implement_$$_Database(); 
  6.         Class<? extends T> implementClass = database.getServiceImplementClass(tClass); 
  7.         if (implementClass != null) { 
  8.             try { 
  9.                 return implementClass.newInstance(); 
  10.             } catch (Exception e) { 
  11.                 e.printStackTrace(); 
  12.             } 
  13.         } 
  14.         return null
  15.     } 

然后在需要配置的地方添加注解即可。

 

  1. @Implements(parent = IUserService.class) 
  2. class UserServiceImpl implements IUserService { 
  3.  
  4.     @Override 
  5.     public String getUserName() { 
  6.         return "UserServiceImpl.getUserName"
  7.     } 

调用姿势。

 

  1. binding.button.setOnClickListener(new View.OnClickListener() { 
  2.         @Override 
  3.         public void onClick(View v) { 
  4.             IUserService userService = InjectHelper.getInstanceByDatabase(IUserService.class); 
  5.             if (userService != null) { 
  6.                 Toast.makeText(getContext(), userService.getUserName(), Toast.LENGTH_SHORT).show(); 
  7.             } 
  8.         } 
  9.     }); 

注意点:

有时候,在生成最终的配置文件的时候,文件的名字是固定的,比如上面的 Implement_$$_Database ,最终的路径是这样的 cn.mycommons.implements.database.Implement_$$_Database.java ,然后通过编译到apk中或则是aar中。

但是有个问题,如果各个子模块都使用了这样的插件,那么每个子模块的就会有这个Implement_$$_Database.class,那么就会编译出错。

因为aar中包含的时候class文件,不是java文件,不能在使用APT做处理了。下面有2中解决方案。

  1. 子工程的插件生成的文件包含一定的规则,比如包含模块名字,如 User_Implement_$$_Database.java ,同时修改编译过程,把java文件也打包到aar中,主工程的插件在编译时候,提取aar中的文件,然后合并子工程的所有的代码,这个思路是可行的,不过技术实现起来比较麻烦。
  2. 同一的方式类似,也是生成有一定规则的的文件,或者在特地package下生成class,这些class再通过接下来的所讲的Gradle Transform方式,生成一个新的Database.class文件。

Gradle Transform

这是Android Gradle编译提供的一个接口,可以供开发自定义一些功能,而我们就可以根据这个功能生成映射匹配,这种方式和APT类似,APT是运行在代码编译时期,而且Transform是直接扫描class,然后再生成新的class,class中包含Map映射信息。修改class文件,使用的是 javassist 一个第三方库。

下面简单讲述代码实现,后面有机会单独写一篇文章讲解。

首先定义一个注解,这个注解用于标注一个实现类的接口。

 

  1. package cn.mycommons.modulebase.annotations; 
  2.  
  3. @Target(ElementType.TYPE) 
  4. @Retention(RetentionPolicy.CLASS) 
  5. public @interface Implements { 
  6.     Class parent(); 

一个测试用的接口以及实现类。

 

  1. public interface ITest { 
  2.  
  3.  
  4. @Implements(parent = ITest.class) 
  5. public class TestImpl implements ITest { 
  6.  

定义一个静态方法,用于获取某个接口的实现类。

 

  1. package cn.mycommons.modulebase.annotations;  
  2. public class ImplementsManager {  
  3.     private static final Map<Class, Class> CONFIG = new HashMap<>();  
  4.     public static Class getImplementsClass(Class parent) { 
  5.         return CONFIG.get(parent); 
  6.     } 

如果不使用任何黑科技,直接使用Java技术,那么在定义时候需要主动的往CONFIG这个map中添加配置,但是这里我们利用transform,直接动态的添加。

定义一个 ImplementsPlugin gradle插件。

 

  1. public class ImplementsPlugin implements Plugin<Project> { 
  2.  
  3.     @Override 
  4.     public void apply(Project project) { 
  5.         AppExtension app = project.getExtensions().getByType(AppExtension.class); 
  6.         app.registerTransform(new ImplementsTransform(project)); 
  7.     } 

自定义的Transform实现。

 

  1. public class ImplementsTransform extends Transform { 
  2.  
  3.     static final String IMPLEMENTS_MANAGER = "cn/mycommons/modulebase/annotations/ImplementsManager.class" 
  4.     static final String IMPLEMENTS_MANAGER_NAME = "cn.mycommons.modulebase.annotations.ImplementsManager" 
  5.     Project project 
  6.  
  7.     ImplementsTransform(Project project) { 
  8.         this.project = project 
  9.     } 
  10.  
  11.     void log(String msg, Object... args) { 
  12.         String text = String.format(msg, args) 
  13.  
  14.         project.getLogger().error("[ImplementsPlugin]:${text}"
  15.     } 
  16.  
  17.     @Override 
  18.     public String getName() { 
  19.         return "ImplementsTransform" 
  20.     } 
  21.  
  22.     @Override 
  23.     public Set<QualifiedContent.ContentType> getInputTypes() { 
  24.         return ImmutableSet.of(QualifiedContent.DefaultContentType.CLASSES) 
  25.     } 
  26.  
  27.     @Override 
  28.     public Set<? super QualifiedContent.Scope> getScopes() { 
  29.         return ImmutableSet.of
  30.                 QualifiedContent.Scope.PROJECT, 
  31.                 QualifiedContent.Scope.PROJECT_LOCAL_DEPS, 
  32.                 QualifiedContent.Scope.SUB_PROJECTS, 
  33.                 QualifiedContent.Scope.SUB_PROJECTS_LOCAL_DEPS, 
  34.                 QualifiedContent.Scope.EXTERNAL_LIBRARIES 
  35.         ) 
  36.     } 
  37.  
  38.     @Override 
  39.     boolean isIncremental() { 
  40.         return false 
  41.     } 
  42.  
  43.     @Override 
  44.     void transform(TransformInvocation transformInvocation) 
  45.             throws TransformException, InterruptedException, IOException { 
  46.         super.transform(transformInvocation) 
  47.         long time1 = System.currentTimeMillis(); 
  48.         log(this.toString() + ".....transform"
  49.  
  50.         TransformOutputProvider outputProvider = transformInvocation.outputProvider 
  51.         outputProvider.deleteAll() 
  52.  
  53.         def classPool = new ClassPool() 
  54.         classPool.appendSystemPath() 
  55.  
  56.         // 记录所有的符合扫描条件的记录 
  57.         List<Entry> implementsList = [] 
  58.         // ImplementsManager 注解所在的jar文件 
  59.         JarInput implementsManagerJar = null 
  60.  
  61.         // 扫描所有的文件 
  62.         transformInvocation.inputs.each { 
  63.             it.directoryInputs.each { 
  64.                 classPool.appendClassPath(it.file.absolutePath) 
  65.                 def dst = outputProvider.getContentLocation(it.name, it.contentTypes, it.scopes, Format.DIRECTORY) 
  66.                 FileUtils.copyDirectory(it.file, dst) 
  67.  
  68.                 project.fileTree(dst).each { 
  69.                     String clazzPath = it.absolutePath.replace(dst.absolutePath, ""
  70.                     clazzPath = clazzPath.replace("/"".").substring(1) 
  71.                     if (clazzPath.endsWith(".class")) { 
  72.                         clazzPath = clazzPath.substring(0, clazzPath.size() - 6) 
  73.                         CtClass clazz = classPool.get(clazzPath) 
  74.                         // 如果class中的类包含注解则先收集起来 
  75.                         Implements annotation = clazz.getAnnotation(Implements.class) 
  76.                         if (annotation != null) { 
  77.                             implementsList.add(new Entry(annotation, clazz)) 
  78.                         } 
  79.                     } 
  80.                 } 
  81.             } 
  82.             it.jarInputs.each { 
  83.                 classPool.appendClassPath(it.file.absolutePath) 
  84.  
  85.                 if (implementsManagerJar == null && isImplementsManager(it.file)) { 
  86.                     implementsManagerJar = it 
  87.                 } else { 
  88.                     def dst = outputProvider.getContentLocation(it.name, it.contentTypes, it.scopes, Format.JAR) 
  89.                     FileUtils.copyFile(it.file, dst) 
  90.  
  91.                     def jarFile = new JarFile(it.file) 
  92.                     def entries = jarFile.entries() 
  93.  
  94.                     // 如果jar中的class中的类包含注解则先收集起来 
  95.                     while (entries.hasMoreElements()) { 
  96.                         def jarEntry = entries.nextElement() 
  97.                         String clazzPath = jarEntry.getName() 
  98.                         clazzPath = clazzPath.replace("/""."
  99.                         if (clazzPath.endsWith(".class")) { 
  100.                             clazzPath = clazzPath.substring(0, clazzPath.size() - 6) 
  101.                             def clazz = classPool.get(clazzPath) 
  102.                             Implements annotation = clazz.getAnnotation(Implements.class) 
  103.                             if (annotation != null) { 
  104.                                 implementsList.add(new Entry(annotation, clazz)) 
  105.                             } 
  106.                         } 
  107.                     } 
  108.                 } 
  109.             } 
  110.         } 
  111.  
  112.         log("implementsManagerJar = " + implementsManagerJar) 
  113.  
  114.         Map<String, String> config = new LinkedHashMap<>() 
  115.  
  116.         implementsList.each { 
  117.             def str = it.anImplements.toString(); 
  118.             log("anImplements =" + it.anImplements) 
  119.             def parent = str.substring(str.indexOf("(") + 1, str.indexOf(")")).replace("parent=""").replace(".class"""
  120.             log("parent =" + parent) 
  121.             log("sub =" + it.ctClass.name
  122.  
  123.             // 收集所有的接口以及实现类的路径 
  124.             config.put(parent, it.ctClass.name
  125.         } 
  126.  
  127.         log("config = " + config) 
  128.  
  129.         long time2 = System.currentTimeMillis(); 
  130.  
  131.         if (implementsManagerJar != null) { 
  132.             def implementsManagerCtClass = classPool.get(IMPLEMENTS_MANAGER_NAME) 
  133.             log("implementsManagerCtClass = " + implementsManagerCtClass) 
  134.  
  135.             // 修改class,在class中插入静态代码块,做初始化 
  136.             def body = "{\n" 
  137.             body += "CONFIG = new java.util.HashMap();\n" 
  138.  
  139.             for (Map.Entry<String, String> entry : config.entrySet()) { 
  140.                 body += "CONFIG.put(${entry.key}.class, ${entry.value}.class);\n" 
  141.             } 
  142.  
  143.             body += "}\n" 
  144.             log("body = " + body) 
  145.  
  146.             implementsManagerCtClass.makeClassInitializer().body = body 
  147.  
  148.             def jar = implementsManagerJar 
  149.             def dst = outputProvider.getContentLocation(jar.name, jar.contentTypes, jar.scopes, Format.JAR) 
  150.             println dst.absolutePath 
  151.  
  152.             // 修改完成后,完成后再写入到jar文件中 
  153.             rewriteJar(implementsManagerJar.file, dst, IMPLEMENTS_MANAGER, implementsManagerCtClass.toBytecode()) 
  154.         } 
  155.  
  156.         log("time = " + (time2 - time1) / 1000) 
  157.     } 
  158.  
  159.     static boolean isImplementsManager(File file) { 
  160.         return new JarFile(file).getEntry(IMPLEMENTS_MANAGER) != null 
  161.     } 
  162.  
  163.     static void rewriteJar(File src, File dst, String name, byte[] bytes) { 
  164.         dst.getParentFile().mkdirs() 
  165.  
  166.         def jarOutput = new JarOutputStream(new FileOutputStream(dst)) 
  167.         def rcJarFile = new JarFile(src) 
  168.  
  169.         jarOutput.putNextEntry(new JarEntry(name)) 
  170.         jarOutput.write(bytes) 
  171.  
  172.         def buffer = new byte[1024] 
  173.         int bytesRead 
  174.         def entries = rcJarFile.entries() 
  175.  
  176.         while (entries.hasMoreElements()) { 
  177.             def entry = entries.nextElement() 
  178.             if (entry.name == namecontinue 
  179.             jarOutput.putNextEntry(entry) 
  180.  
  181.             def jarInput = rcJarFile.getInputStream(entry) 
  182.             while ((bytesRead = jarInput.read(buffer)) != -1) { 
  183.                 jarOutput.write(buffer, 0, bytesRead) 
  184.             } 
  185.             jarInput.close() 
  186.         } 
  187.  
  188.         jarOutput.close() 
  189.     } 

映射匹配总结

优点:

  • Map:简单明了,很容易入手,不会对编译时间产生任何影响,不会随着Gradle版本的升级而受影响,代码混淆时候不会有影响,无需配置混淆文件。
  • APT:使用简单,使用注解配置,代码优雅,原理是用代码生成的方式生成新的文件。
  • Transform:使用简单,使用注解配置,代码优雅,原理是用代码生成的方式生成新的文件,不过生成的文件的时期和APT不同,会编译时间产生少许影响。

缺点:

  • Map:在需要新添加映射的时候,需要手动添加,不然不会生效,代码不优雅。
  • APT:在编译时期生成文件,会编译时间产生少许影响,同时在不同的Gradle的版本中可能会产生错误或者兼容问题。需要配置混淆设置,不然会丢失文件。技术实现复杂,较难维护。
  • Transform:在编译时期生成文件,会编译时间产生少许影响,同时在不同的Gradle的版本中可能会产生错误或者兼容问题。需要配置混淆设置,不然会丢失文件。技术实现复杂,较难维护。

从技术复杂性以及维护性来看,Map > APT = Transform

从使用复杂性以及代码优雅性来看,Transform > APT > Map

开发调试技巧

Debug

上面介绍了很多关于模块化的概念以及技术难题,当模块化完成以后,再进行完成开发时候还是会遇到不少问题。不如原先代码在一起的时候很方便的进行代码调试。但是进行模块化以后,直接使用的是aar依赖,不能直接修改代码,可以使用下面技巧,可以直接进行代码调试。

在根目录下面创建一个module目录以及module.gradle文件,这个目录和文件是git ignore的,然后把对应的模块代码clone到里面,根目录的setting.gradlew apply module.gradle文件,如下所示,如果需要源码调试,则在module中添加对应的模块。然后在app的依赖中去掉aar依赖,同时添加项目依赖即可。当不需要源码调试好,再修改为到原先代码即可。

 

  1. try { 
  2.     apply from"./module.gradle" 
  3. } catch (e) { 

module.gradle

  1. include ':ModuleShopping' 

比如调试shopping模块

 

  1. // common 
  2.     compile 'cn.mycommons:base:1.0.0' 
  3.     compile 'cn.mycommons:component:1.0.0' 
  4.     compile 'cn.mycommons:service:1.0.0' 
  5.  
  6.     // biz 
  7.     compile 'cn.mycommons:user:1.0.0' 
  8.     compile 'cn.mycommons:order:1.0.0' 
  9.     // compile 'cn.mycommons:shopping:1.0.0' 
  10.     compile project(':ModuleShopping'

当然还有个更具技术挑战性方案,使用gradle插件的形式,如果发现root项目中包含的模块化的源码,则不适用aar依赖,直接使用源码依赖,当然这个想法是不错的,不过具有技术挑战性,同时有可能随着Gradle版本的升级,编写的gradle插件也要做相对于的兼容风险,这是只是简单提示一下。

容器设计

上面讲到的如果要调试代码时候,需要完整的运行的整个项目,随着项目的增大,编译时间可能变得很长。

我们可以做一个简单的,类似与主app模块一样,比如我是负责user模块的开发者,那么我只要调试我这个模块就行了,如果需要其他的模块,我可以简单的做一个mock,不是把其他的模块直接依赖过来,这样可以做到调试作用。等到再需要完整项目调试时候,我们在使用上面介绍的方式,这样可以节省不少开发时间。

还有一种实现调试的方式,比如上面的user模块,目录下面的build.gradle文件是这样的

 

  1. apply plugin: 'com.android.library'  
  2. xxx 
  3. xxx 

我们可以在gradle.properties中设置编译变参数isLibModule,当需要完整调试好,设置为 isLibModule=false ,这样我这个子模块就是一个 apply plugin: 'com.android.application' 这样的模块,是可以单独运行的一个项目

 

  1. try { 
  2.     if (isLibModule) { 
  3.         apply from"./build_lib.gradle" 
  4.     }else
  5.         apply from"./build_app.gradle" 
  6.     } 
  7. } catch (e) { 

可能有时候还是需要单独的运行环境,android编译方式有2中,一种是debug,一种是release。当打包成aar的时候,使用的是release方式,我们可以把需要调试的代码全部放到debug中,这样打包的时候就不会把调试的文件发布到aar中。不过这种实现方式,需要对Android项目的目录有较高的认识,才可以熟练使用。

CI

上面介绍的各个模块需要单独到独立的git仓库,同时打包到单独的maven仓库,当开发完成后,这时候就需要进行打包,但这个是一个简单和重复的事情,所以我们需要一个工具来完成这些事情,我们可以利用CI系统来搞定这件事情,这里我推荐Jenkins,主流厂商使用jenkins作为CI服务器这个方案。

具体的步骤就是,需要对每个模块的git仓库做web hook,我们公司使用的是git lab,可以对git的各种操作做hook,比如push,merge,tag等。

当代码发送了变化了,我们可以发送事件到CI服务器,CI服务器再对各个事件做处理,比如user模块develop分支有代码变化,这个变化可能是merge,也有可能是push。我们可以把主项目代码和user项目的代码单独clone下拉,然后编译一下,确认是否有编译问题,如果有编译通过,那么在使用相关gradle命令发布到maven仓库中。

不管每次编译结果怎样,是成功还是失败,我们都应该把结果回馈给开发者,常见的方式是邮件,不过这个信息邮件方式可能很频繁,我们建议使用slack。

总结

模块化架构主要思路就是分而治之,把依赖整理清楚,减少代码冗余和耦合,在把代码抽取到各自的模块后,了解各个模块的通信方式,以及可能发生的问题,规避问题或者解决问题。***为了开发和调试方便,开发一些周边工具,帮助开发更好的完成任务。

责任编辑:未丽燕 来源: Github
相关推荐

2017-07-04 13:59:28

Android模块化

2014-10-21 11:17:41

苹果设计

2011-07-13 09:13:56

Android设计

2020-12-16 06:33:06

thisJava调用

2017-10-23 12:22:58

Android编程基础总结

2017-02-13 18:46:38

Android模块化组件化

2014-07-29 16:21:57

Git

2018-05-17 11:23:06

智能化

2012-12-19 09:36:49

测试自动化测试

2015-11-23 17:32:19

新程序员程序员

2021-10-25 05:49:25

模块化UPS电源

2017-05-18 11:43:41

Android模块化软件

2019-08-28 16:18:39

JavaScriptJS前端

2012-09-25 10:03:56

JavaJava封面Java开发

2021-10-11 09:51:37

模块化UPS架构

2015-12-03 11:45:31

PHP7 发布

2009-11-30 09:00:48

模块化路由器

2011-12-08 21:42:36

Android

2018-07-23 12:03:01

2009-06-18 09:51:25

Java继承
点赞
收藏

51CTO技术栈公众号