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

文章目录

• 一、settings.gradle 构建脚本分析
• • 1、Maven 远程仓库配置
  • 2、目录配置
  • 3、完整代码示例
• 二、根目录下 build.gradle 构建脚本分析

一、settings.gradle 构建脚本分析

1、Maven 远程仓库配置

pluginManagement 脚本块 ,

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

dependencyResolutionManagement 脚本块 ,

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

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

repositoriesMode 模式有两种 :

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

参考之前的 【Android Gradle 插件】Android 依赖管理 ② ( 为工程配置依赖仓库 | 为工程构建添加依赖仓库 | classpath 引入依赖库 | 配置依赖仓库 ) 博客中的配置 ,

• 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
}

在 plugins 中使用

id 'com.android.application' version '7.3.1' 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'
    }
}