【Android Gradle 插件】settings.gradle 配置文件 ( 配置基本作用 | include 函数用法 | 目录层级配置 | 修改 Module 模块构建脚本名称 )

Android Plugin DSL Reference 参考文档 : https://google.github.io/android-gradle-dsl/2.3/

一、settings.gradle 配置

---

1、基本作用

settings.gradle 是 Gradle 配置文件 , 这里如果有多个 Module , 可以在此处配置所有的 Module 项目 ;

2、include 函数用法

上面的

include ':app'
1

代码 , 在 Groovy 语法中 , 就是调用了 include 方法 , 传入了 ‘:app’ 字符串作为参数 ;

类似于

println "hello world"
1

打印字符串方法 ;

该 include 方法 , 定义在了 Settings.java 中 ;

在该 settings.gradle 脚本中 , 调用了 include 方法 , 参数是 ‘:app’ 字符串 ;

3、Module 目录层级配置

上述字符串换中的冒号是用于分割目录的 , 如果再次创建一个 app2 目录 , 配置文件会自动变为

include ':app'
rootProject.name = "SVG"
include ':app2'
1
2
3

如果将 app2 目录放在 另一个 other 目录中 , 则需要将配置文件修改为 :

include ':app'
rootProject.name = "SVG"
include ':other:app2'
1
2
3

( 此处不能使用 “/” 或 “\” 符号分割文件目录 , 必须使用 “:” 分割目录 )

4、修改 Module 模块的 build.gradle 默认构建脚本名称

默认情况下 , Module 模块的默认构建脚本是 build.gradle , 这个脚本是可以修改的 ;

调用 project 方法 , 可以获取工程描述符 ;

ProjectDescriptor project(String var1) throws UnknownProjectException;
1

然后调用 工程描述符 ProjectDescriptor 的 setBuildFileName 方法 , 可以设置对应 Module 的默认构建脚本名称 ;

public interface ProjectDescriptor {
    void setBuildFileName(String var1);
}
1
2
3

使用

project(':app').buildFileName = 'a.gradle'
1

代码 , 将 app 模块的默认构建脚本修改为 a.gradle 脚本 ;