Gradle系列之构建脚本基础

原文首发于微信公众号：躬行之(jzman-blog)

前面两篇文章分别介绍了 Gradle 基础知识以及 Groovy 相关基础知识，这也是学习 Gradle 所必需了解的，文章连接以下：：

• Gradle系列之初识Gradle
• Gradle之Groovy基础篇

本文将对 Gradle 总体进行了介绍和学习，了解了 Task、Project 等相关概念以及对使用 Gradle 来构建项目的一些经常使用操做，主要内容以下：

1. Setting 文件
2. Build 文件
3. Project 和 Tasks
4. 任务的建立
5. 任务依赖
6. 任务间的交互
7. 自定义属性
8. 总结

Setting 文件

说一下 Gradle 构建项目的 Setting 文件，该文件主要用来配置当前工程，好比 Android 开发中一个项目中可能有多个子 Module，当不须要某个子 Module 时，能够取消该 Module 在配置文件 Setting 中的配置便可，固然只有在 Setting 文件中配置的子 Module 才会被构建，固然不仅是 Android 开发，只要使用 Gradle 构建的项目都同样，Setting 是 Gradle 构建项目默认的配置文件名，下面简单测试一下 Setting.gradle 文件的使用，测试工程目录以下：

├─GradleSetting
│  ├─.gradle
│  │  ├─4.1
│  │  │  ├─fileChanges
│  │  │  ├─fileHashes
│  │  │  └─taskHistory
│  │  └─buildOutputCleanup
│  └─test
│      └─Method
│          └─.gradle
│              ├─4.1
│              │  ├─fileChanges
│              │  ├─fileHashes
│              │  └─taskHistory
│              └─buildOutputCleanup
│ build.gradle
│ setting.gradle

在工程名为 GradleSetting 的工程中 test 文件夹下有一个 Method 的子项目，这里会经过配置 setting.gradle 文件将子项目 Method 构建到 GradleSetting 中，setting.gradle 文件内容以下：

println "---------test----Setting.gradle----------"
//输出当前工程目录
println(rootDir)
//指定要参与构建的子项目
include ':Method'
project(':Method').projectDir = new File(rootDir,'test/Method')

来看一下输出结果：

PS E:\Gradle\study\GradleSetting> gradle testGradleSetting
---------test----Setting.gradle----------
E:\Gradle\study\GradleSetting

> Configure project :
testGradleSetting

> Configure project :Method
3
3
30
获取方法返回的结果：30
1
2
3
4
5


BUILD SUCCESSFUL in 2s

由于在 setting.gradle 文件中配置了 Method，从输出结果看 Method 确实参与了构建，取消在 setting.gradle 文件中的配置，则不会构建 Method，最好本身验证一下。

上面配置了子项目 Method 所在的位置，若是不指定则默认是与 setting.gradle 同级的目录。

Build 文件

若是选择使用 Gradle 构建项目，则每一个项目都有一个 build.gradle 文件，该文件是项目构建的入口，对整个项目的配置生效，能够在根项目配置子项目的一下通用配置，好比配置子项目的仓库为 jcenter，这样子项目中全部的依赖就指向 jcenter 中心库下载，下面是参考代码：

//配置子项目依赖的仓库
subprojects{
    repositories{
        jcenter()
    }
}

//配置所有项目
allprojects{
    
}

...

经过本小节主要了解 build.gradle 文件的做用便可，实际开发中针对不一样类型的项目会有更详细的相应配置策略。

Project 和 Tasks

在 Gradle 中有不少 Project，可将某个 Project 打包成 jar 提供给另外一个 Project 使用，每一个 Project 都是根据其业务需求抽象出来的一个子模块，最终经过 Gradle 构建成完整的项目。

每一个 Project 容许有多个 task，Task 理解为任务，task 主要 完成某个具体的功能点，好比 wrapper task 主要就是完成 wrapper 文件的建立。

任务的建立

对于任务的建立已经比较熟悉了，下面使用 task 声明一个任务：

//1. 建立一个任务
task createTask{
    doFirst{
        println 'doFirst'
    }

    doLast{
        println 'doLast'
    }
}

//2. 使用TaskContainer建立一个任务,Project已经定义的TaskContainer,即tasks
tasks.create("createTask1"){
    doFirst{
        println 'doFirst'
    }

    doLast{
        println 'doLast'
    }
}

task 能够理解为建立任务的关键字，实际上 task 是 Project 里面的一个方法，在 Groovy 中能够省略方法参数上的括号，花括号里的内容是一个闭包，主要是对 task 进行相关配置，doFirst 和 doLast 是 Task 中经常使用的两个方法，分别会在该 task 开始和结束时执行。

任务依赖

任务之间能够相互依赖，能够控制某个任务执行的前后顺序，好比在运行 A 以前必须先运行 B，此时任务 A 依赖任务 B，具体参考以下代码：

//单任务依赖：经过dependsOn指定要依赖的任务
task B(dependsOn: A){
    doFirst{
        println 'B'
    }
}

task C{
    doFirst{
        println 'C'
    }
}

//多任务依赖
task D{
    dependsOn A, C
    doFirst{
        println 'D'
    }
}

下面看一下执行多依赖任务 gradle D 的执行结果：

PS E:\Gradle\study\GradleSetting> gradle D

> Task :A
A

> Task :C
C

> Task :D
D

BUILD SUCCESSFUL in 2s

显然，执行任务 D，其依赖的其余两个任务先执行，控制了任务执行的前后顺序。

注意：脚本是按照顺序执行，若是任务任务 A 和 C 在任务 D 的后面定义，当执行任务 D 的时候确定会出错。

任务间的交互

建立的任务都有本身的名称，其类型是 Task，那么咱们就能够经过 Task API 来控制控制任务的执行，使用任务名操做任务的原理是：Project 在建立任务的时候，已经将该任务对应的任务声明为 Project 对象的一个类型为 Task 的一个属性，测试代码以下：

//任务之间的交互
task E{
    println 'hello e'
    println "E是否是Project的属性："+project.hasProperty('E')
}

E.doFirst{
    println 'doFirst'
}

E.doLast{
    println 'doLast'
}

上述代码的执行结果以下：

PS E:\Gradle\study\GradleSetting> gradle E

> Configure project :
hello e
E是否是Project的属性：true

> Task :E
doFirst
doLast


BUILD SUCCESSFUL in 1s

自定义属性

Project 和 Task 都容许用户添加额外的自定义属性，经过应用所属对应的 ext 属性来实现，添加以后能够经过 ext 属性对自定义的属性进行读取和设置，若是要同时添加多个自定义属性，能够经过 ext 代码块，参考以下代码定义自定义属性：

apply plugin:"java"

//自定义单个属性
ext.name1 = "Gradle"
//自定义多个属性
ext{
    age = 10
    score = 100
}

//在SourceSet中使用自定义属性
sourceSets.all{
    ext.resourceDir = null
}

//配置自定义属性
sourceSets{
    main{
        resourceDir = "main/res"
    }
    test{
        resourceDir = "test/res"
    }
}

task customProperty{
    println "name=${name1}"
    println "age=${age}"
    println "score=${score}"

    sourceSets.each {
        println "${it.name} resourceDir is ${it.resourceDir}"
    }
}

上述代码的执行结果：

PS E:\Gradle\study\GradleSetting> gradle customProperty

> Configure project :

name=Gradle
age=10
score=100
main resourceDir is main/res
test resourceDir is test/res

BUILD SUCCESSFUL in 2s

自定义属性相较局部变量做用域更加普遍，能够跨 Task、Project 访问自定义属性，只要能访问这些属性所属的对象，那么这些属性就能够被访问到， Android 开发中可使用自定义属性单独定义版本号、版本名称以及用到的第三方库的版本，将其赞成在单独的 gradle 文件中，各 Module 直接获取便可，不只方便管理依赖库的版本，还在必定程度上提升工做效率。

总结

Gradle 脚本基于 Grooy ,而 Groovy 彻底兼容 Java 语法，Gradle 脚本本质上仍是代码，在 Gradle 中能够利用相关语法来完成相关功能。能够关注公众号：零点小筑（jzman-blog），一块儿交流学习。