Android—Gradle教程(八)

前言

到目前为止,Gradle基础知识已经讲解完毕,对Gradle的实战也讲解了好几个了。在本篇里,将会以Gradle在组件化的使用进行详解。

1. 什么是组件化?

在回答这个问题之前首先回想一下以前我们是怎么开发的。

如图所示

之前我们开发项目的时候,就是通过定义不同的包名来表示对应的功能,比如这里的product用来表示商品列表以及商品详情相关的业务逻辑【这部分由程序员A完成】;order用来表示订单相关的业务逻辑【这部分由程序员B完成】

突然有一天,程序员A找到程序员B,怒气冲冲的说到:“你干嘛要改我商品相关的输出参数,你这一改我商品部分全乱套了!”。程序员B回怼到:“我的订单输入参数写的很规范很标准,你那太不规范了,你调用我的订单就要按照我的标准来!”。。。。

此时作为Android组长的你,看到自己俩手下争得不可开交。就思考着能不能把他们负责的功能模块从总工程移出去,让他们自己开发自己的,然后像导入Library的方式一样,将他们负责的模块引入到主工程里。

Library并不能单独运行,但又想做到他们自己开发自己的,就思考着能不能他们开发的时候,对应模块能够独立运行,组装功能点的时候,又把他们开发的功能模块切换成Library

于是乎,你带着疑问就开始查看主Module 与 Library的区别:

对应的bulid.gradle

对应的AndroidManifest.xml

我们发现,主Module 与 Library的区别无非就是这两点不同。那尝试一下将Library改成主Module

这里按照刚刚的区别,重新引入了关于主Module 的AGP脚本插件,并且在defaultConfig里面额外添加了ApplicationId属性。

对应的AndroidManifest.xml 也丰富了起来,重新编译项目。

已经成功编译,此时你应该清楚了 主Module 与 Library 相互之间转换的步骤。

所以说组件化就是开发时每个模块都可成为独立运行模块,给主Module 组装功能时又会变成对应模块的Library !

2. 开始搭建组件化框架

2.1 组件化框架初始版

于是乎,你就对原Library 进行改造。

//plugins {
//    id 'com.android.library'
//    id 'kotlin-android'
//}

project.ext{
    isModuleDebug=true
}

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

apply plugin: 'kotlin-android'

android {
    compileSdkVersion 30

    defaultConfig {
        if (project.isModuleDebug) {
            applicationId "com.hqk.main"
        }
        minSdkVersion 28
        targetSdkVersion 30
        versionCode 1
        versionName "1.0"

        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    }

    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
    kotlinOptions {
        jvmTarget = '1.8'
    }

    sourceSets {
        main {  //通过 sourceSets  可以指定 编译对象对应的目标路径
            if (project.isModuleDebug) {
                manifest.srcFile "src/debug/AndroidManifest.xml"
            } else {
                manifest.srcFile "src/main/AndroidManifest.xml"
            }
        }
    }

}

dependencies {

    implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
    implementation 'androidx.core:core-ktx:1.3.1'
    implementation 'androidx.appcompat:appcompat:1.2.0'
    implementation 'com.google.android.material:material:1.2.1'
    implementation 'androidx.constraintlayout:constraintlayout:2.0.1'
    testImplementation 'junit:junit:4.+'
    androidTestImplementation 'androidx.test.ext:junit:1.1.2'
    androidTestImplementation 'androidx.test.espresso:espresso-core:3.3.0'
}

你选择通过一个变量来控制该模块是Module 还是 Library ,这样就可以根据变量值动态切换Module 与 Library之间的状态!

但是现在问题来了,因为每个人都负责自己独立这块,就可能会出现:编译版本不统一,还有个更严重的问题就是依赖功能点不同。比如说程序员A喜欢用OKHttp,程序员B喜欢用XUtil,他俩互相看不惯对方依赖的三方库,到后面组装功能点的时候还是会吵起来,而且还会造成更多的冗余代码。

那思考下有啥方法可以避免该问题呢?能不能把这些配置,以及依赖统一放在一起,然后每个功能模块单独引入一下?引入??好像之前学的那个脚本插件就是靠引入的方式的嘛!

于是乎,你对Gradle脚本进行了大改。

2.2 组件化框架进阶版

在根目录创建新的脚本文件:common.gradle

project.ext {

    // 模块是否单独运行调试
    isModuleDebug = true

    //统一版本号
    minSdkVersion = 21
    targetSdkVersion = 30
    versionCode = 1
    versionName = "1.0"
    compileSdkVersion = 30
    applicationId = "com.hqk.gradledemo06"

    //    implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
//    implementation 'androidx.core:core-ktx:1.3.1'
//    implementation 'androidx.appcompat:appcompat:1.2.0'
//    implementation 'com.google.android.material:material:1.2.1'
//    implementation 'androidx.constraintlayout:constraintlayout:2.0.1'

//    implementation 'com.alibaba:arouter-api:arouter:1.5.1'

    //组装所有模块依赖的对象
    libs = [
            "appcompat"       : "androidx.appcompat:appcompat:1.2.0",
            "k-stdlib"        : "org.jetbrains.kotlin:kotlin-stdlib:1.5.10",
            "ktx"             : "androidx.core:core-ktx:1.3.1",
            "material"        : "com.google.android.material:material:1.2.1",
            "constraintlayout": "androidx.constraintlayout:constraintlayout:2.0.1",
            "arouter"         : "com.alibaba:arouter-api:1.5.1"
    ]


    apts = [
            "ARouterCompiler": "com.alibaba:arouter-compiler:1.5.1",
    ]

    // 专门用来设置application module的
    setAppDefaultConfig = {
        project ->
            project.apply plugin: "com.android.application"
            project.apply plugin: "kotlin-android"
            setAndroidConfig project.android
            setDependencies project.dependencies
    }

    setAndroidConfig = {
        android ->
            android.compileSdkVersion project.compileSdkVersion

            android.defaultConfig {
                minSdkVersion project.minSdkVersion
                targetSdkVersion project.targetSdkVersion
                versionCode project.versionCode
                versionName project.versionName
                
                //如果当前project是主module的话加入project.applicationId
                if (project.name == 'app') {
                    applicationId project.applicationId
                } else if (project.isModuleDebug) {
                    //如果功能模块需要独立运行的话,在原有applicationId后加上对应模块的后缀
                    applicationId project.applicationId
                    applicationIdSuffix = project.name
                }

                testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"

                javaCompileOptions {
                    annotationProcessorOptions {
                        // 路由每个模块的名称
                        arguments += [AROUTER_MODULE_NAME: project.name]
                    }
                }
            }

            android.buildTypes {
                release {
                    minifyEnabled false
                    proguardFiles android.getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
                }
            }
            android.compileOptions {
                sourceCompatibility JavaVersion.VERSION_1_8
                targetCompatibility JavaVersion.VERSION_1_8
            }
            android.kotlinOptions {
                jvmTarget = '1.8'
            }

            android.sourceSets {
                main {
                    if (project.name != 'app') {
                        //如果当前project为功能模块的话,将会根据是否独立运行来设置AndroidManifest路径
                        if (project.isModuleDebug) {
                            manifest.srcFile "src/debug/AndroidManifest.xml"
                        } else {
                            manifest.srcFile "src/main/AndroidManifest.xml"
                        }
                    }
                }
            }
    }

    // 定义专门为library情况下进行配置
    setLibDefalutConfig = {
        project.apply plugin: "com.android.library"
        project.apply plugin: "kotlin-android"
        setAndroidConfig project.android
        setDependencies project.dependencies
    }

    setDependencies = {
        dependencies ->
            delegate = dependencies
            //遍历依赖上面组装好的依赖
            project.libs.each {
                k, v -> implementation v
            }
            project.apts.each {
                k, v -> annotationProcessor v
            }
            testImplementation 'junit:junit:4.+'
            androidTestImplementation 'androidx.test.ext:junit:1.1.2'
            androidTestImplementation 'androidx.test.espresso:espresso-core:3.3.0'

            //如果当前project为主module并且其他功能模块为library时,需要依赖对应的功能模块
            if (project.name == 'app' && !project.isModuleDebug) {
                implementation project(':buissiness:login')
                implementation project(':buissiness:main')
            }
    }

}

if (project.name == 'app' || isModuleDebug) {
    // 除了app以外,还有组件调试的情况,就直接调用setAppDefaultConfig
    project.setAppDefaultConfig project
} else {
    project.setLibDefalutConfig project
}


大致的统一的脚本写好了,剩下的就只是各个功能模块以及主Module依赖该脚本了。

主Module对应的build.gradle

apply from: "${rootProject.rootDir}/common.gradle" // 这是一种脚本插件

对应功能模块对应的build.gradle【首页main功能模块】

apply from: "${rootProject.rootDir}/common.gradle" // 这是一种脚本插件

对应功能模块对应的build.gradle【登录login功能模块】

apply from: "${rootProject.rootDir}/common.gradle" // 这是一种脚本插件

//下面只是举例,在依赖公共脚本的同时,可以对单个功能点做特殊处理。
// 自己这个工程的处理就再次调用相关的这些闭包执行
android {

}

dependencies {
    println "login dependencies"
    api project(':base:baseLib')
}

到这所有配置全部配置完毕,现在来试一下效果:

isModuleDebug = true 时

所有的功能模块都能单独运行!

那么当isModuleDebug = false 时

功能模块就已经变成了对应library资源了。也就是说,我们的Gradle在组件化的配置已经成功了。

Demo下载地址:点我下载

结束语

好了,今天Gradle对应的组件化配置实战到这里结束了。在之后的架构专栏里,将会完美的实现组件化的所有操作。

因为Gradle脚本既支持Groovy脚本,也支持Kotlin脚本,所以后面会涉及到Gradle如何从Groovy脚本转换成Kotlin脚本。考虑到还有小伙伴未加入Kotlin大军来,因此下一章将会从零开始讲解Kotlin。觉得看文章比较枯燥的小伙伴,可以看看下方的视频教程。

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

推荐阅读更多精彩内容