微信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.
插件安装步骤:
- 打开 [File] -> [Settings...] -> [plugins] -> [Browse repositories...]
- 搜索插件名称 MicroModule
插件详解:
https://plugins.jetbrains.com/plugin/10785-micromodule
插件项目地址:
https://github.com/EastWoodYang/micro-module-idea-plugin
最后
MicroModule已经上传至Github,欢迎star交流。
https://github.com/EastWoodYang/MicroModule