Android模块化之MicroModule(微信Pins工程)

微信Pins工程

相信你看过微信关于模块化的分享《微信Android模块化架构重构实践》,也注意到里面提到的pins工程结构。

Android模块化之MicroModule(微信Pins工程)

作者是这样描述的 ------“pins工程能在module之内再次构建完整的多子工程结构,通过project.properties来指定编译依赖关系。通过依赖关系在编译时找到所有的资源和源码路径。”

仔细推敲这句话的意思,应该能知道它实现的基本原理------通过设置sourceSets指定多个java、res等路径.

有关sourceSets的介绍:
https://developer.android.com/studio/build/index.html#sourcesets
https://google.github.io/android-gradle-dsl/current/com.android.build.gradle.api.AndroidSourceSet.html

但是,有一个问题需要要知道的是,一个module只能指定一个AndroidManifest文件,pins工程中包含了多个AndroidManifest,它是怎么做到的?

研究过com.android.tools.build:gradle,会留意到它使用到一个子库com.android.tools.build:manifest-merger,官方通过这个库来合并多个AndroidManifest文件,或许pins工程也是用了这方式。

接下来,再它的基础上,我做的一些改动,取了另一个名字叫 MicroModule,先来看一下工程结构:

Android模块化之MicroModule(微信Pins工程)

与pins工程的结构大致不变,增加了androidTesttest,以及将project.properties替换为build.gradle

MicroModule 介绍

基本原理是不变的,与微信pins工程一样配置sourceSets。AndroidManifest合并用了com.android.tools.build:manifest-merger

Usage

在根项目的build.gradle中添加插件依赖:

buildscript {
    repositories {
        jcenter()
        ...
    }
    dependencies {
        classpath 'com.eastwood.tools.plugins:micro-module:1.0.1'
        ...
    }
}

在模块的build.gradle中引用插件并配置 MicroModule:

// 'micro-module'要置于'com.android.application'或'com.android.library'前。
apply plugin: 'micro-module'
apply plugin: 'com.android.application'

// 为了防止两个没有依赖关系的MicroModule产生引用,可以开启下面这个代码边界检查插件。
// apply plugin: 'micro-module-code-check'

...

microModule {
    // 这里的include类似于settings.gradle中include。
    include ':p_home'
    include ':p_common'
    include ':p_base'
}

MicroModule中的build.gradle:

dependencies {
    implementation microModule(':MicroModule名称') // 定义依赖关系,引用其他MicroModule
    
    // 你也可以在这里依赖其他第三方库
    // implementation '***'
    // api '***'
    // ...
}

为了使用上的更加方便,专门写了Android Studio的插件,能快速的创建一个MicroMoudle.

Android模块化之MicroModule(微信Pins工程)

插件安装步骤:

  1. 打开 [File] -> [Settings...] -> [plugins] -> [Browse repositories...]
  2. 搜索插件名称 MicroModule

Android模块化之MicroModule(微信Pins工程)

插件详解:
https://plugins.jetbrains.com/plugin/10785-micromodule

插件项目地址:
https://github.com/EastWoodYang/micro-module-idea-plugin

最后

MicroModule已经上传至Github,欢迎star交流。
https://github.com/EastWoodYang/MicroModule

相关推荐