Android组件化实现方案(一)

这里的组件化每个模块可以单独运行、打包、测试,可随意拆卸、随意组装,既不互相依赖又可以互相调用。是通过在一个Project下通过创建多个Module实现的。
假设三个模块:App(可以认为是首页或是空壳)、ShoppingCar、Order。

问题一:每个Module下都有build.gradle,怎么统一管理版本号和引入包?

  1. 在Project目录下创建config.gradle,并且在Project目录下的build.gradle中引入:
// Top-level build file where you can add configuration options common to all sub-projects/modules.

apply from: "config.gradle"

buildscript {
   ...
}

allprojects {
   ...
}

...
  1. config.gradle中统一管理:
// 添加多个自定义属性,可以通过ext代码块
ext {

    androidId = [
            compileSdkVersion: 28,
            buildToolsVersion: "29.0.0",
            minSdkVersion    : 21,
            targetSdkVersion : 28,
            versionCode      : 1,
            versionName      : "1.0"
    ]

    appId = [
            app    : "com.yu.modular",
    ]


    supportLibrary = "28.0.0"
    dependencies = [
            "appcompat" : "com.android.support:appcompat-v7:${supportLibrary}",
            "recyclerview" : "com.android.support:recyclerview-v7:${supportLibrary}",
            "constraint" : "com.android.support.constraint:constraint-layout:1.1.3"
    ]
}
  1. app的build.gradle中使用:
apply plugin: 'com.android.application'

// 赋值与引用
def androidId = rootProject.ext.androidId
def appId = rootProject.ext.appId
def support = rootProject.ext.dependencies

android {
    compileSdkVersion androidId.compileSdkVersion
    buildToolsVersion androidId.buildToolsVersion
    defaultConfig {
        applicationId appId.applicationId
        minSdkVersion androidId.minSdkVersion
        targetSdkVersion androidId.targetSdkVersion
        versionCode androidId.versionCode
        versionName androidId.versionName
        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])

    // 标准写法
    // implementation group: 'com.android.support', name:'appcompat-v7', version:'28.0.0'
    // 简写
    // implementation 'com.android.support:appcompat-v7:28.0.0'

    // 依赖第三方库最简洁的方式:
    support.each { k, v -> implementation v } // 上面已经定义过support,是在Project的config.gradle中统一管理的

}

其他的Module的build.gradle中也是一样用,只是如果是library的话不需要applicationId

问题二:怎么组合Module? 怎么单独运行Module?

如果创建Module的是Phone & Tablet Module, 那么这个Module是可以单独运行的,但是怎么集成进app?这样的Module直接implementation会报循环引用的错误。
如果创建Module的是Android Library,那这个Module是可以在app中引入的,但是这样的Module如何独立运行?

这里就需要动态去切换Module的类型。对比Phone Module和Android Library的build.gradle可看出不同处只有两点:

  • Phone Module中:apply plugin: 'com.android.application',而Android Library中:apply plugin: 'com.android.library'
  • Phone Module有applicationId,而Android Library没有。

要完成在Module的类型切换,只需要动态修改这两个地方。
config.gradle中定义一个标签用来标示组件化还是集成化,并且统一管理Module的applicationId:

ext {
    // false: 组件化模式(子模块可以独立运行),true :集成化模式(打包整个项目apk,子模块不可独立运行)
    isRelease = false
    ···
    appId = [
            app      : "com.yu.modular",
            order    : "com.yu.order",
            shopping : "com.yu.shopping"
    ]
    ...
}

app中不需要修改,无论什么环境下都是Phone Module,下面以order模块的build.gradle为例,按上面两个不同点,这里需要修改一下两处:

if (isRelease) {
    apply plugin: 'com.android.library'
} else {
    apply plugin: 'com.android.application'
}

...
def appId = rootProject.ext.appId

android {

    ...

    defaultConfig {
        if (!isRelease) {
            applicationId appId.order
        }
        ...
    }

    ...

}

...

ShoppingCar也需要做同样修改,然后在app的build.gradle中加入:

apply plugin: 'com.android.application'

...

dependencies {
    ...

    if (isRelease) {
        implementation project(':order')
        implementation project(':shoppingcar')
    }
}

这里有两点需要注意:

  • 创建Module的时候建议选择Phone & Tablet Module,如果选择的是Android Library,AndroidManifest文件和res目录内容不全,需要手动修改。
  • Module中java和res目录下的命名前面尽量加上Module名,类似:Order_MainActivity.javaorder_activity_main.xml这样,方便区分。

完成以上操作,只要修改config.gradle中的isRelease,就可以实现集成化和插件化的切换了。isRelease=true时,打包出来是一个apk,除app外其他的module不可以单独运行;isRelease=false时,打包出来有几个module做过上述配置就有几个apk,所有的module都可以单独运行。

isRelease = true,集成化

isRelease = false,插件化

问题三:Debug时候的一些类并不想在Release的时候打包进去,怎么去隔离这些文件?比如单独模块提供给测试的时候,需要有个Activity去模拟触发其他模块传递过来的操作,而这个Activity打包的时候并不需要。

这里需要为这些module在不同环境下创建不同的AndroidManifest文件,并且设置Release环境下的过滤目录,以Order模块为例,在Order的build.gradle文件中添加:

...

android {

    ...

    // 配置资源路径,方便测试环境,打包不集成到正式环境
    sourceSets {
        main {
            if (!isRelease) {
                // 如果是组件化模式,需要单独运行时
                manifest.srcFile 'src/main/debug/AndroidManifest.xml'
            } else {
                // 集成化模式,整个项目打包apk
                manifest.srcFile 'src/main/AndroidManifest.xml'
                java {
                    // release 时 debug 目录下文件不需要合并到主工程
                    exclude '**/debug/**'
                }
            }
        }
    }

}

...

对应创建出文件和目录:


这样在debug包下的文件,就不会打包进Release时的apk中,如果是Activity,也只需要配置Debug环境下的AndroidManifest就可以。这里就不贴图了,可以在打包出来的apk中验证下(验证时关闭分包更好找一些)。

问题四:公共基础库怎么引用,比如图片下载,网络请求等?

这里没什么特殊处理,新创建一个Android Library,比如:common,然后再需要用到的module的build.gradle中跟引入其他三方库一样,添加:

..
dependencies {
    ...

    implementation project(':common') // 公共基础库
}

问题五:集成化的Module之间怎么交互?

集成化环境下app模块可以调用其他的模块,因为isRelease==true时会引入其他模块:

    if (isRelease) {
        implementation project(':order')
        implementation project(':shoppingcar')
    }

但是其他模块之间的互相调用呢?
EventBus?很杂,不方便管理。
反射?高版本api有可能被@hide。
隐示意图?广播? 都不够舒服,没人愿意这么写。
先看下面两种实现方式

  1. 用类加载
Class clazz = Class.forName("com.yu.modular.shoppingcar.ShoppdingCar_MainActivity");
Intent intent = new Intent(this, clazz);
startActivity(intent);

这样写很容易写错先不说,一旦一模块修改了包名或类名,其他模块都要改,很难维护。

  1. 在公共库common中对Activity进行统一管理,因为各模块都引入了公共库common,所以都可以对common进行操作。

公共库的PathManager:

public class PathManager {

    /**
     *
     * @param groupName 组名,如:"order"
     * @param pathName  路劲名,如:"Order_MainActivity"
     * @param clazz     类对象,如:Order_MainActivity.class
     */
    public static void set(String groupName, String pathName, Class<?> clazz) {
        ...
    }

    /**
     *
     * @param groupName 组名
     * @param pathName  路径名
     * @return 跳转目标的class类对象
     */
    public static Class<?> get(String groupName, String pathName) {
        ...
    }
    ...
}

以什么形式存?
这里把Activity路径和类封装成一个Bean去储存:

public class PathBean {
    private String path;
    private Class clazz;

    public PathBean(String path, Class clazz) {
        this.path = path;
        this.clazz = clazz;
    }

    ...
}

Map里的存储结构类似这样:

[
  app : [app_PathBean1,  app_PathBean2, app_PathBean3],
  shoppingCar: [shoppingCar_PathBean1,  shoppingCar_PathBean2, shoppingCar_PathBean3],
  order: [order_PathBean1,  order_PathBean2, order_PathBean3]
]

什么时候去存?如果在Activity中去存肯定是来不及的,所以app(主模块)的Application的onCreate方法中去存:

public class AppApplication extends BaseApplication {
    @Override
    public void onCreate() {
        super.onCreate();

        PathManager.set("app", "MainActivity", MainActivity.class);
        PathManager.set("shoppingcar", "ShoppingCar_MainActivity", MainActivity.class);
        PathManager.set("order", "Order_MainActivity", MainActivity.class);
    }
}

跳转时这样调用:

    Class clazz = PathManager.get("order", "Order_MainActivity");
    Intent intent = new Intent(this, clazz);
    startActivity(intent);

这样就完成集成化模块间通讯了。
项目地址

手动去管理这个存储的Map还是不太舒服,有没有什么办法可以自动生成?
有,使用APT+JavaPoet技术。Android组件化实现方案(二)

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 159,117评论 4 362
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,328评论 1 293
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,839评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 44,007评论 0 206
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,384评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,629评论 1 219
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,880评论 2 313
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,593评论 0 198
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,313评论 1 243
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,575评论 2 246
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,066评论 1 260
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,392评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,052评论 3 236
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,082评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,844评论 0 195
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,662评论 2 274
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,575评论 2 270

推荐阅读更多精彩内容

  • 不怕跌倒,所以飞翔 组件化开发 参考资源 Android组件化方案 为什么要组件化开发 解决问题 实际业务变化非常...
    笔墨Android阅读 2,903评论 0 0
  • 转载请标明出处: http://blog.csdn.net/guiying712/article/details/...
    吕志豪阅读 1,867评论 1 39
  • MVVMHabitComponent 关于Android的组件化,相信大家并不陌生,网上谈论组件化的文章,多如过江...
    goldze阅读 5,083评论 2 22
  • 1. Android组件化开发 在Android项目组件化之前,我们的项目都是像下图那样,一个单一工程下,根据不同...
    CHSmile阅读 4,422评论 1 34
  • ——读《张幼仪传》有感 读这本书,从开始到大半数,我都为张幼仪感到不值。身为徐志摩的原配妻子,她为徐志摩奉献了一生...
    1704李鑫阅读 489评论 0 0