Android模块化之MicroModule（微信Pins工程）

微信Pins工程

相信你看过微信关于模块化的分享《微信Android模块化架构重构实践》，也注意到里面提到的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，先来看一下工程结构：

与pins工程的结构大致不变，增加了androidTest和test，以及将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.

插件安装步骤:
1. 打开 [File] -> [Settings…] -> [plugins] -> [Browse repositories…]
2. 搜索插件名称 MicroModule

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

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

最后

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