Android 组件化 各个Module统一配置Gradle文件

最新推荐文章于 2025-05-14 13:50:08 发布
原创 最新推荐文章于 2025-05-14 13:50:08 发布 · 1.2k 阅读 · 1 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#Android 组件化 #Android 插件化 #组件化 插件化 #Android 路由跳转 #ARouter路由

本文详细介绍了一种组件化配置方案，包括如何统一管理Gradle文件中的依赖，并实现组件既可以单独运行也能整合进壳工程中。此外，还介绍了组件化开发的优点及其在实际项目中的应用。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

一.简介

 

组件化开发中，我们可能会有很多的Module。那么就会有很多的Gradle文件。再加上项目本身的三个Gradle文件。每一个Gradle中使用的各种依赖需要统一管理。下面我们来讲解各个Module统一配置Gradle文件的内容。

 

 

 

 

 

 

二.配置

 

1.项目截图

 

 

2.说明

component_base 是基础Module 包含一些公共的引用，比如 约束布局constraintlayout。不可单独运行。


component_main 是主Module 可以单独运行。


component_ui 是UI相关Nodule 可以单独运行。

 

 

3.自定义的Gradle文件内容

ext {
    /** true 每个业务Module可以单独开发 false 每个业务Module以lib的方式运行 */
    isComponentMainModule = true//Main组件
    isComponentUIModule = true//UI组件

    /** 项目中各种版本号管理 */
    versions = [
            compileSdkVersion      : 30,//compileSdkVersion
            applicationId          : "com.wjn.componentdemo",//应用ID
            minSdkVersion          : 16,//minSdkVersion
            targetSdkVersion       : 30,//targetSdkVersion
            versionCode            : 1,//版本号
            versionName            : "1.0.0",//版本名称

            javaVersion            : 1.8,//Java SDK版本号

            appcompatVersion       : "1.2.0",//appcompat版本号
            materialVersion        : "1.2.1",//material版本号
            constraintlayoutVersion: "2.0.2",//ConstraintLayout版本号
            junitVersion           : "4.13.2",//junit版本号
    ]

    /** 项目中dependencies依赖管理 */
    dependencies = [
            appcompat       : "androidx.appcompat:appcompat:${versions["appcompatVersion"]}",
            material        : "com.google.android.material:material:${versions["materialVersion"]}",
            constraintlayout: "androidx.constraintlayout:constraintlayout:${versions["constraintlayoutVersion"]}",
            junit           : "junit:junit:${versions["junitVersion"]}",
    ]
}

 

 

4.APP的Gradle文件内容

plugins {
    id 'com.android.application'
}

android {

    compileSdkVersion rootProject.ext.versions.compileSdkVersion

    defaultConfig {
        applicationId rootProject.ext.versions.applicationId
        minSdkVersion rootProject.ext.versions.minSdkVersion
        targetSdkVersion rootProject.ext.versions.targetSdkVersion
        versionCode rootProject.ext.versions.versionCode
        versionName rootProject.ext.versions.versionName

        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    }

    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }

    compileOptions {
        sourceCompatibility rootProject.ext.versions.javaVersion
        targetCompatibility rootProject.ext.versions.javaVersion
    }
}

dependencies {

    /** 公共依赖包 */
    implementation project(':component_base')
    /** 是否加载 component_main */
    if (!Boolean.valueOf(rootProject.ext.isComponentMainModule)) {
        implementation project(':component_main')
    }

    /** 是否加载 component_ui */
    if (!Boolean.valueOf(rootProject.ext.isComponentUIModule)) {
        implementation project(':component_ui')
    }
}

 

 

5.component_base组件的Gradle文件内容

apply plugin: 'com.android.library'

android {

    compileSdkVersion rootProject.ext.versions.compileSdkVersion

    defaultConfig {
        minSdkVersion rootProject.ext.versions.minSdkVersion
        targetSdkVersion rootProject.ext.versions.targetSdkVersion
        versionCode rootProject.ext.versions.versionCode
        versionName rootProject.ext.versions.versionName

        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    }

    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }

    compileOptions {
        sourceCompatibility rootProject.ext.versions.javaVersion
        targetCompatibility rootProject.ext.versions.javaVersion
    }
}

dependencies {
    api rootProject.ext.dependencies["appcompat"]
    api rootProject.ext.dependencies["material"]
    api rootProject.ext.dependencies["constraintlayout"]
    api rootProject.ext.dependencies["junit"]
}

注意：为了避免项目中多个Module重复依赖相同的依赖问题，比如可能多个Module都会依赖约束布局constraintlayout。这样我们抽出一个Base的Module，然后在这个Module中通过api的方式引入需要的依赖。这样其他的Module只需要引入该Base即可。然后每个Module单独使用的依赖，还是和普通项目一样使用implementation引入相关依赖即可。

 

 

6.component_main组件的Gradle文件内容

/** 修改处1：根据isComponentMainModule字段 决定该Module的产物*/
if (Boolean.valueOf(rootProject.ext.isComponentMainModule)) {
    apply plugin: 'com.android.application'
} else {
    apply plugin: 'com.android.library'
}

android {

    compileSdkVersion rootProject.ext.versions.compileSdkVersion

    defaultConfig {
        /** 修改处2：根据isComponentMainModule字段 决定是否可以有applicationId 只有单独运行时才可以有applicationId*/
        if (Boolean.valueOf(rootProject.ext.isComponentMainModule)) {
            applicationId "com.wjn.component.main"
        }
        minSdkVersion rootProject.ext.versions.minSdkVersion
        targetSdkVersion rootProject.ext.versions.targetSdkVersion
        versionCode rootProject.ext.versions.versionCode
        versionName rootProject.ext.versions.versionName

        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    }

    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }

    /** 修改处3：sourceSets闭包 配置不同文件夹的清单文件 根据isComponentMainModule字段 */
    sourceSets {
        main {
            if (Boolean.valueOf(rootProject.ext.isComponentMainModule)) {
                manifest.srcFile 'src/main/module/AndroidManifest.xml'
            } else {
                manifest.srcFile 'src/main/AndroidManifest.xml'
            }
        }
    }

    compileOptions {
        sourceCompatibility rootProject.ext.versions.javaVersion
        targetCompatibility rootProject.ext.versions.javaVersion
    }
}

dependencies {
    /** 公共依赖包 */
    implementation project(':component_base')
    /** 本Module独立使用的依赖 */
}

 

 

7.component_ui组件的Gradle文件内容

/** 修改处1：根据isComponentUIModule字段 决定该Module的产物*/
if (Boolean.valueOf(rootProject.ext.isComponentUIModule)) {
    apply plugin: 'com.android.application'
} else {
    apply plugin: 'com.android.library'
}

android {

    compileSdkVersion rootProject.ext.versions.compileSdkVersion

    defaultConfig {
        /** 修改处2：根据isComponentUIModule字段 决定是否可以有applicationId 只有单独运行时才可以有applicationId*/
        if (Boolean.valueOf(rootProject.ext.isComponentUIModule)) {
            applicationId "com.wjn.component.ui"
        }
        minSdkVersion rootProject.ext.versions.minSdkVersion
        targetSdkVersion rootProject.ext.versions.targetSdkVersion
        versionCode rootProject.ext.versions.versionCode
        versionName rootProject.ext.versions.versionName

        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    }

    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }

    /** 修改处3：sourceSets闭包 配置不同文件夹的清单文件 根据isComponentUIModule字段 */
    sourceSets {
        main {
            if (Boolean.valueOf(rootProject.ext.isComponentUIModule)) {
                manifest.srcFile 'src/main/module/AndroidManifest.xml'
            } else {
                manifest.srcFile 'src/main/AndroidManifest.xml'
            }
        }
    }

    compileOptions {
        sourceCompatibility rootProject.ext.versions.javaVersion
        targetCompatibility rootProject.ext.versions.javaVersion
    }
}

dependencies {
    /** 公共依赖包 */
    implementation project(':component_base')
    /** 本Module独立使用的依赖 */
}

 

 

 

 

 

三.验证

为了验证上述配置是否正确，咱们打两个包。一个包是两个Module单独运行，一个包是两个Module作为组件为壳工程使用。

 

1.两个Module单独运行

<1> 配置开关

isComponentMainModule = true//Main组件

isComponentUIModule = true//UI组件



<2> 打出的包清单文件

<?xml version="1.0" encoding="utf-8"?>
<manifest
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:versionCode="1"
    android:versionName="1.0.0"
    android:compileSdkVersion="30"
    android:compileSdkVersionCodename="11"
    package="com.wjn.componentdemo"
    platformBuildVersionCode="30"
    platformBuildVersionName="11">

    <uses-sdk
        android:minSdkVersion="16"
        android:targetSdkVersion="30" />

    <uses-permission
        android:name="android.permission.ACCESS_WIFI_STATE" />

    <uses-permission
        android:name="android.permission.READ_EXTERNAL_STORAGE" />

    <uses-permission
        android:name="android.permission.INTERNET" />

    <application
        android:theme="@ref/0x7f0f0196"
        android:label="@ref/0x7f0e001b"
        android:icon="@ref/0x7f0c0000"
        android:allowBackup="true"
        android:supportsRtl="true"
        android:roundIcon="@ref/0x7f0c0001"
        android:appComponentFactory="androidx.core.app.CoreComponentFactory">

        <activity
            android:name="com.wjn.componentdemo.MainActivity">

            <intent-filter>

                <action
                    android:name="android.intent.action.MAIN" />

                <category
                    android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>

        <activity
            android:name="com.wjn.component.base.BaseMainActivity" />

        <activity
            android:name="com.wjn.component.base.BaseTestActivity" />
    </application>
</manifest>

 

 

<3> 运行及验证结果

运行正常，且清单文件中不包含两个Module的Activity。验证成功。

 

 

 

2.两个Module作为组件为壳工程使用

<1> 配置开关

isComponentMainModule = false//Main组件

isComponentUIModule = false//UI组件

 

 

<2> 打出的包清单文件

<?xml version="1.0" encoding="utf-8"?>
<manifest
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:versionCode="1"
    android:versionName="1.0.0"
    android:compileSdkVersion="30"
    android:compileSdkVersionCodename="11"
    package="com.wjn.componentdemo"
    platformBuildVersionCode="30"
    platformBuildVersionName="11">

    <uses-sdk
        android:minSdkVersion="16"
        android:targetSdkVersion="30" />

    <uses-permission
        android:name="android.permission.ACCESS_WIFI_STATE" />

    <uses-permission
        android:name="android.permission.READ_EXTERNAL_STORAGE" />

    <uses-permission
        android:name="android.permission.INTERNET" />

    <application
        android:theme="@ref/0x7f0f0196"
        android:label="@ref/0x7f0e001b"
        android:icon="@ref/0x7f0c0000"
        android:allowBackup="true"
        android:supportsRtl="true"
        android:roundIcon="@ref/0x7f0c0001"
        android:appComponentFactory="androidx.core.app.CoreComponentFactory">

        <activity
            android:name="com.wjn.componentdemo.MainActivity">

            <intent-filter>

                <action
                    android:name="android.intent.action.MAIN" />

                <category
                    android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>

        <activity
            android:name="com.wjn.component.main.MainMainActivity" />

        <activity
            android:name="com.wjn.component.ui.UIMainActivity" />

        <activity
            android:name="com.wjn.component.ui.UITestActivity" />

        <activity
            android:name="com.wjn.component.base.BaseMainActivity" />

        <activity
            android:name="com.wjn.component.base.BaseTestActivity" />
    </application>
</manifest>

 

 

<3> 运行及验证结果

运行正常，且清单文件中包含两个Module的所有Activity。验证成功。

 

 

 

 

 

 

四.总结

通过三篇文章的讲解，我们就完成了组件化的初步配置，下面我们来总结一下。

 

1.前言

普通项目的缺点(尤其是项目稍微复杂一些时)

<1> 编译运行一次很慢。

<2> 修改其中一个点，可能也需要对其他模块进行简单的测试。

<3> 提交代码很容易造成代码冲突。

<4> 排查问题，比较麻烦。

<5> ...

 

 

 

2.模块化

Android Studio中，新建一个工程默认有一个App module。然后我们还可以通过File->New->New Module 新建module。那么这里的“module” 实际就是“模块”的意思。那么模块化相比普通的项目的优点是什么呢？它相比组件化的缺点是什么呢？

 

<1> 相比普通项目优点

解决了刚刚说的普通项目的缺点。

 

<2> 相比组件化缺点

[2.1] 每个模块不能独立运行。

[2.2] 项目比较复杂时，每个模块间存在相互依赖。

[2.3] ...

 

 

 

3.组件化的优点

<1.1> 各个组件可以单独运行，方便调试。

<1.2> 我们可以把一些基础的内容放到一个基础的组件中，比如 定位功能 网络请求功能 Json解析功能 原生UI功能等等。这样其他组件只需要依赖这个基础的组件即可。其他组件不需要相互依赖。

<1.3> 组件化中依赖原则是上层可以依赖下层，下层不可依赖上层，同层之间也尽量不要相互依赖。

<1.4> ...

 

 

 

4.组件化注意事项

组件化开发中除了刚刚说的依赖问题，还需要注意一下内容。

 

为了使每一个Module既可以单独运行又可以依附壳工程运行，需要修改几个点

<1> 修改清单文件

<2> 修改Gradle文件

详情：https://blog.youkuaiyun.com/weixin_37730482/article/details/70243289 

 

 

 

 

android studio 实现对module统一资源配置
T丶快乐知己丬
09-29 3843
说明 android studio开发采用的Project下多module模式开发，每个module下对应一个build.gradle文件对所在的module进行版本，依赖进行配置，这里我们就来实现多个module配置统一在project下配置。 实现 1. 在project根目录下创建配置文件config.gradle 这里我只对编译Sdk版本，build工具版本及design依
详解Android使用Gradle统一配置依赖管理
08-28
总之，通过在Android项目中使用Gradle的统一配置文件，我们可以有效地管理项目依赖，确保所有Module的依赖版本一致，避免了因版本不匹配引发的编译错误。这不仅提高了项目的维护性和稳定性，也简化了团队协作和代码...
AndroidStudio 多个module统一gradle文件配置
LXB-89
08-27 3202
随着项目的不断迭代更新，项目变的也越来越大，为了减少编译时间，开发效率，大多采用模块化，组件化开发，moudle 的个数也会随着增加，那么一些依赖或sdk版本升级的时候，每个 moudle 的 gradle 可能都需要修改一遍，统一管理配置就显得比较重要了。网上也给出了几种实现方式，这里只针对个人觉得比较好的方式做介绍。 一、配置 在 project 根目录建一个文件夹 config，里面...
Java中的“指针”迷思
最新发布
2502_90978586的博客
05-14 444
引用将底层的内存操作抽象为对象关系的管理，体现了Java“一切皆对象”的核心理念，也让开发者能以更高的视角构建软件系统。对于开发者而言，理解引用的本质（而非纠结于“是否是指针”的概念之争），方能真正掌握Java的内存模型、参数传递机制及GC原理，进而写出高效、安全的Java代码。虚引用无法获取对象实例，仅用于跟踪对象的GC状态——当对象被回收时，虚引用会被加入引用队列，供底层系统监控内存回收行为。这种机制的核心逻辑是：引用变量的值是对象地址，传递引用即传递地址副本，但地址指向的对象是共享的。
Gradle多模块项目配置
xiaoguangtouqiang的博客
09-30 1363
springboot gradle 多模块项目配置
buildSrc + gradle插件：多项目共享gradle依赖管理
xx23x的博客
04-10 3153
自定义gradle 插件，配合 buildSrc 形式的组件库版本管理， 用于实现多 project 项目共享一套版本管理信息
Gradle 第七讲 之 android插件的入门2 SourceSets
热门推荐
低调的成长
12-11 1万+
SourceSets 并非是安卓插件中引入的，而是java插件中引入的，所以只要理解其一，即可贯通， 我们先来介绍一下在java插件中如何使用， 1.gradle的资源路径一般都是固定的， /src/main/java/*** /src/test/java/*** 也就是说我们再不编辑sourceSets的情况下，只有这里面的代码才会被编辑, test中的是测试代码。
【Android 组件化】使用 Gradle 实现组件化 ( 组件 / 集成模式下的 Library Module 开发 )
05-15
【Android 组件化】使用 Gradle 实现组件化 ( 组件 / 集成模式下的 Library Module 开发 ) https://hanshuliang.blog.youkuaiyun.com/article/details/116845118 博客源码快照
你们要的Android组件化来了，module单独编译运行
05-21
"你们要的Android组件化来了，module单独编译运行"这个标题表明我们将讨论如何实现Android应用的组件化，使得每个模块可以独立编译和运行，这在大型项目中非常关键，因为它提高了开发效率并降低了集成风险。...
Android组件化Gradle基础配置及应用示例
资源摘要信息:"Component-based.zip文件是针对Android组件化开发的一套资源包，其中包含了基础的配置文件以及多个模块实例，这些实例详细地展示了如何使用Gradle来实现Android应用的组件化架构。" Android组件化是...
Android 组件化开发module间通信
11-12
本篇文章将重点讨论Android组件化开发中的模块间Activity如何相互启动以及如何进行数据传递。 首先，`Activity`是Android四大组件之一，它是用户与应用交互的主要界面。在组件化开发中，由于各个模块是相互独立的，...
gradle的配置相关
jc15274630894的博客
04-01 5258
gradle的配置文件
【Android Gradle 插件】AaptOptions 配置 ⑥ ( Overlay 重叠包机制 | AaptOptions#additionalParameters 附加参数配置 )
让 学习 成为一种 习惯 ( 韩曙亮 の 技术博客 )
05-06 1540
一、Overlay 重叠包机制、 二、AaptOptions#additionalParameters 附加 -S 参数配置实现Overlay 重叠包机制
Android gradle SourceSets介绍与使用
oneblue123的博客
11-03 1万+
转载：https://blog.youkuaiyun.com/lbcab/article/details/72771729 java插件引入了一个概念叫做SourceSets，通过修改SourceSets中的属性，可以指定哪些源文件（或文件夹下的源文件）要被编译，哪些源文件要被排除。Gradle就是通过它实现Java项目的布局定义。  SourceSets目录结构是固定的Java的标准项目目录布局   ...
Android-模块化-项目实践和探索分享
Extra Lazy的博客
03-29 1万+
提示：这里需要提前对Android-模块化-基本知识了解本文主要分享个人在项目中实现Android模块化中的gradle统一配置、nexus、maven-publish、动态依赖、模块通信等思路组件化项目demo模块的依赖对应关系应该采用map数据结构构建关系，key为project，value为上面的依赖切换详情项依赖的传递性可以采用递归循环压缩依赖信息为map，project、moudule、dep_option字段必须依赖项配置:、api、、、、等，其中api具有传递性依赖信息为map，
android module 简书,Android解决多module引用库统一问题
weixin_28868483的博客
06-05 1043
场景：随着业务的增长，app程序越来越庞大，引用的library也越来越多。但是有些共同引用的库在每个module版本的设置不同，每个module设置的minSdkVersion、targetSdkVersion等也不尽相同。假如你使用butterknife或dagger2，需要在每个module配置annotationProcessor，如annotationProcessor‘com.goog...
【Gradle多模块系列2】在子项目之间声明依赖关系和共享构建逻辑示例详解
wang2leee的博客
12-16 1720
【Gradle多模块系列2】在子项目之间声明依赖关系和共享构建逻辑示例详解
Android 进阶——Gradle 源集管理和多源集多渠道定制不同解决方案的分享
最美不过，心中有梦，身旁有你！
02-08 2113
文章大纲引言一、Android Studio vs Gradle vs Android 插件二、多渠道定制前需要掌握的重要术语1、 源集SourceSet1.1、构建时Gradle 将`java/` 目录中的所有源代码将编译输出1.2、构建时 Gradle 将所有源集的清单按优先级合并到一个清单文件1.2.1、构建变体的清单文件1.2.2、应用模块的主清单文件1.2.3、所包含的库中的清单文件1.3、构建时Gradle 将`values` 下的资源文件合并在一起1.4、构建时Gradle 将`res`和`a
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值