【Android Gradle 插件】Android Studio 工程 Gradle 构建流程 ( settings.gradle 构建脚本分析 | 根目录下 build.gradle 分析 )

一、settings.gradle 构建脚本分析

pluginManagement 脚本块 ,

用于 配置 Gradle 插件的 Maven 仓库 ,
配置的是 构建过程 中 , 使用的仓库 ;
dependencyResolutionManagement 脚本块 ,

用于 配置 依赖 的 Maven 仓库 ,
配置的是 工程 或 模块 下的依赖使用的仓库 ;

在 dependencyResolutionManagement 脚本块 中 定义的

 repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) 代码的含义是 解析依赖时 , 只能使用本脚本块中的 Maven 仓库 , 不能使用 Module 子项目中的依赖 ;

repositoriesMode 模式有两种 :

RepositoriesMode.PREFER_PROJECT : 解析依赖库时 , 优先使用本地仓库 , 本地仓库没有该依赖 , 则使用远程仓库 ;
RepositoriesMode.FAIL_ON_PROJECT_REPOS : 解析依赖库时 , 强行使用远程仓库 , 不管本地仓库有没有该依赖库 ;

 

pluginManagement 脚本块中的 repositories 配置 , 对应之前的 buildscript 中的 repositories 配置 ;
dependencyResolutionManagement 脚本块中的 repositories 配置 , 对应之前的 allprojects 中的 repositories 配置 ;
 

2、目录配置

settings.gradle 构建脚本中的目录设置 :

• rootProject.name 用于指定工程根目录 , 在该目录下有一个 build.gradle 构建脚本 , 声明后会自动执行该构建脚本 ;

 

	rootProject.name = "LiveDataDemo"

include 用于指定子项目 , 在子项目中也有一个 build.gradle 构建脚本 , 声明后会自动执行该构建脚本 ;

include ':app'

3、完整代码示例

完整代码示例 :

pluginManagement {
    repositories {
        gradlePluginPortal()
        google()
        mavenCentral()
    }
}
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
    }
}
rootProject.name = "LiveDataDemo"
include ':app'

二、根目录下 build.gradle 构建脚本分析

根目录下 build.gradle 构建脚本如下 :

// Top-level build file where you can add configuration options common to all sub-projects/modules.
plugins {
    id 'com.android.application' version '7.3.1' apply false
    id 'com.android.library' version '7.3.1' apply false
    id 'org.jetbrains.kotlin.android' version '1.7.20' apply false
}

 

配置 Gradle 插件 , 下面分析每个配置的含义 :

引入 com.android.application 插件 ,
version '7.3.1' 说明引入插件的版本号 ,
apply false 表示当前不会马上引用该插件 , 在 Module 子项目 中使用到该插件时 , 才能正式应用 ;
在此处 主要是为了说明 Gradle 插件的版本 , 没有其它含义 ;
 

如 : 在 Module 子项目中 , 有如下配置 : 

plugins {
    id 'com.android.application'
    id 'org.jetbrains.kotlin.android'
}

 

则会立刻应用 com.android.application 和 org.jetbrains.kotlin.android Gradle 插件 , 此处就不会有插件版本了 ;

在之前的 build.gradle 配置 中 , 在 " buildscript / dependencies / classpath " 中 , 配置 Android Gradle 插件版本 是 4.2.1 , 也就是

com.android.application
com.android.library

 插件 的 版本 ;

buildscript {
    repositories {
        google()
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:4.2.1'
    }
}