一、基础概念

settings.gradle 文件位于项目的根目录下，用于定义项目级代码库设置，并告知 Gradle 在构建应用时应将哪些模块包含在内。对于大多数项目，该文件默认如下所示：

pluginManagement {
    repositories {
        gradlePluginPortal()
        google()
        mavenCentral()
    }
}
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
    }
}
rootProject.name = "My Application"
include ‘:app’

二、常用属性

image.png

可以执行: gradle projects 或者 ./gradlew projects 查看projects结构

正确:

include ':app'
rootProject.name="NetworkOptimization"

include 'app' // 因为app就在根目录下
rootProject.name="NetworkOptimization"

image.png

错误:

include 'NetworkOptimization/app'
rootProject.name="NetworkOptimization"

image.png

三、多项目设置

// 包括项目'foo:bar' 
include 'foo:bar' 

// 包括一个项目目录与逻辑项目路径不匹配的项目
include 'baz' 
project( ':baz' ).projectDir = file( 'foo/baz' )

// 包括许多项目目录与逻辑项目路径不匹配的项目
file( 'subprojects' ).eachDir { dir -> 
  include dir.name
  项目( ":${dir.name}" ).projectDir = dir 
}

四、拓展

settings.gradle 对应的是org.gradle.api.initialization.Settings , 支持的属性是提供的函数. 可以阅读源码了解原理

除了已提供的函数外还可以自定义函数, 这些函数会在gradle构建整个工程任务的时候执行, 所以可以在settings做一些初始化的工作

def initGradleSetting(){
    println "initGradleSetting  -> "
}
//settings.gradle加载的时候，会执行initGradleSetting
initGradleSetting()

include ':app'
rootProject.name="NetworkOptimization"