Android构建配置第一个文件setting.gradle解读

一、setting.gradle作用

    settings.gradle 作为Android 项目构建配置的入口文件,它主要有以下五点作用:

1.定义项目根目录名称

rootProject.name = "MyAndroidProject"  // 项目根目录名称

    根项目名称是整个项目的唯一标识,在编译、打包、CI/CD等一些需要根据这个名称来标识这个项目。如果没有显性定义项目根目录名称,rootProject.name的默认值就是项目根目录文件夹名称。

2. 定义参与编译的模块和路径

假设项目结构如下:

MyProject/
├── settings.gradle
├── build.gradle
├── app/
│   └── build.gradle
├── custom/
│   ├── customView/
│   │   └── build.gradle

就要如此定义

include ':app'      

include ':customView'                 // 必须
project(":customView").projectDir = new File("custom/customView")     // 默认值是根目录下的模块文件夹

其他模块依赖的时候示例是

 api project(':customview')

如果在setting.gradle这样声明

include ':app'   
include ':custom:customView'   

其他模块依赖的时候示例是

 api project('custom:customview')

3.全局插件管理(新Gradle 7.0+)

pluginManagement {
    // 插件仓库
    repositories {
        gradlePluginPortal()       // gradle插件库地址
        google()
        mavenCentral()
    }
    // 插件版本,如果这里不显性配置,则默认获取最新
    plugins {
        id 'com.android.application' version '8.1.0'     // 类似于 classpath 'com.android.tools.build:gradle:3.5.4'
        id 'org.jetbrains.kotlin.jvm' version '1.9.10'
    }
}

4.依赖仓库集中管理(新Gradle 7.0+)

dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
    }
}
这个类似于之前在根目录build.gradle中配置的
allprojects {
    repositories {
        maven { url 'http://maven.aliyun.com/nexus/content/groups/public/' }
        google()
        maven { url 'https://jitpack.io' }
        jcenter()
        }
}

5.初始化gradle全局扩展属性ext

def deps = [:]    // 定义一个map
gradle.ext.deps = deps    // 通过将 deps 绑定到 gradle.ext,可以在项目中的其他地方(如子模块的 build.gradle 文件)引用这些依赖。
def baselib = [
        rxjava       : "io.reactivex:rxjava:1.2.3",
        rxandroid    : "io.reactivex:rxandroid:1.2.0",
        mystique     : 'com.baidu:mystique:0.1.135',
        glide        : 'com.baidu.mapclient.thirdpart.base:glide:3.9.1.8',
        lottie       : 'com.airbnb.android:lottie:3.7.1',
        okhttp       : "com.squareup.okhttp3:okhttp:3.11.0",
    ]
deps.platform = platform

    这段代码通过在setting.gradle中初始化全局属性.gradle.ext,来实现集中管理和动态分配依赖,提高项目的维护性和可扩展性。将依赖存储在一个全局 Map 中,并通过 gradle.ext 暴露给整个项目,减少了重复声明依赖的工作,确保多个模块中依赖的一致性。

    gradle.ext 是gradle默认作用域,你可以省略 ,可以在各个模块中如下使用

dependencies {
    implementation deps.baselib.rxjava   // 等同于 implementation ext.deps.baselib.rxjava
}

二、setting.gradle执行阶段和适用场景

    setting.gradle是构建配置的入口文件,在gradle初始化阶段第一个被解析和执行。所以我们才把项目模块、插件管理、依赖仓库管理、全局属性、以及一些自定义的初始化逻辑、全局方法等放在setting.gradle之中。这也是之前定义在根目录build.gradle的一部分功能在gradle高版本被迁移到setting.gradle中原因

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

推荐阅读更多精彩内容