什么是gradle

简单的说gradle是一套构建工具，所谓构建工具就是根据一堆输入信息，生成一系列产物，复杂的说gradle是一套框架，所有的参数配置其实都严格对应相应的API，我们没有必要可以记住这些API，我们需要掌握的是大体流程，然后借助官方SDK+API来完成自己的需求。

为什么会有gradle

在Gradle爆红之前，常用的构建工具是ANT，然后又进化到Maven。ANT和Maven这两个工具其实也还算方便，现在还有很多地方在使用。但是二者都有一些缺点，所以让更懒得人觉得不是那么方便。比如，Maven编译规则是用XML来编写的。XML虽然通俗易懂，但是很难在xml中描述if{某条件成立，编译某文件}/else{编译其他文件}这样有不同条件的任务。于是gradle就应运而生，gradle采用的语言是groovy，groovy能让你写java语言像写脚本一样简单，同时gradle是一种DSL语言，即Domain Specific Language，领域相关语言。什么是DSL，说白了它是某个行业中的行话。在gradle的体现有很多，比如sourceSets代表源文件的集合等。

如何使用gradle

1.首先我们需要学习一下groovy，值得一提的是groovy语言在编译的时候已经编译为java类字节码，然后运行在JVM虚拟机中，可以理解为它扩展了Java语言，写法十分的奔放，比如定义变量使用def定义，但是这个关键字也不是必需的，语句结尾可以不使用;，单引号严格对应Java中的双引号，双引号则和脚本语言中的双引号类似，当含有$符号时，则它会$表达式先求值，三引号中的字符串支持换行。暂时先了解这些，详细的可以直接看GDK。
2.接下来我们就介绍一下gradle的行话，在gradle中，每一个待编译的工程都是一个Project对象，每个Project在编译的时候包含多个Task，比如一个Android项目的编译可能就包含Java源码编译Task、资源编译Task、JNI编译Task、lint检查的Task、打包生成APK的Task、签名Task等等。一个Project包含的Task的数量是由编译脚本执行的插件决定的，插件就是用来定义Task，并且具体执行这些Task的东西。而gradle作为一个框架，主要负责定义流程和规则，具体的编译工作则是通过编译插件来完成，比如编译Java有Java插件，编译Groovy有Groovy插件，编译Android APP有Android APP插件，编译Android Library有Android LIbrary插件。该图片中有两个Project，根据gradle设计，每一个Project都对应一个build.gradle对象，而build.gradle就是该Project的编译脚本，如果只有这些，那么你编译的就需要进入到每一个Project中，然后执行编译脚本，这样效率很低，于是gradle提供了Multi-Projects Build，即多个项目一起编译，实现很简单，就是再项目根目录增加一个build.gradle文件，然后再增加一个settings.gradle，前者可以什么都不写，后者就是通过include标签将所有的Project包含进来，如：include ':app', ':buildsrc'，同时我们还可以在这里添加一些初始化的函数，比如：

1
2
3
4
5
6
7
	def initSomeValue(){
    Properties properties = new Properties();
    File fileProperties = new File(rootDir.getAbsolutePath()+"/local.properties");
    properties.load(fileProperties.newDataInputStream());
    gradle.ext.myApi = properties.getProperty("sdk.dir");
    println("init"+gradle.myApi);
}

该函数就是将SDK的目录赋值给gradle的额外属性myApi中，下次直接通过gradle.myApi获取该属性。目前我们了解的内容如下：
每一个Project都必须设置一个build.gradle文件。
对于multi-projects build，需要在根目录下也放一个build.gradle，和一个settings.gradle。
一个Project是由若干tasks来组成的，当gradle xxx的时候，实际上是要求gradle执行xxx任务。这个任务就能完成具体的工作。
下面说一下gradle的工作流程，简单地说就是先执行settings.gradle，完成初始化过程，然后解析每一个build.gradle，其中的Task会被添加到有向图中，用于解决依赖关系，最后就是执行阶段，执行gradle XXX，gradle就会将这个xxx任务链上的所有任务全部按依赖顺序执行一遍。接下来介绍几种对象：
1.Gradle对象，当执行gradle XXX的时候，gradle会从默认的配置脚本中构造一个Gradle对象，在整个构建过程中只有一个Gradle对象，Gradle对象的数据类型就是Gradle。我们一般很少去定制这个默认的配置脚本。
2.Project对象，每一个build.gradle对象都会生成一个Project对象，在gradle中，Project对象对应的是Build Script，在build.script中，我们一般需要做如下几件事，分别是：应用插件、设置属性等。
3.Settings对象，每个settings.gradle都会生成一个Settings对象，注意，对于其他gradle文件，除非定义了class，否则会转换成一个实现了Script接口的对象。这一点和3.5节中Groovy的脚本类相似。
讲了这么多，那么一般怎么用呢？对于Java和Groovy而言，我们一般会把公共的方法放在一个类中，然后在别的类中import该类，但是在Gradle中，一般都是通过在build.gradle中定义插件，然后在插件中定义Task来完成，定义Task可以通过task函数来定义，一个Task包含多个Action，所以Task有两个函数，分别是doFirst和doLast，即最先执行和最后执行。普及了基础知识，接下来直接看这个项目吧,代码里差不多都有注释。这里需要再补充的就是自定义gradle插件步骤：
1.新建一个module（我一般是选择Android Library）

2.除了main文件夹和build.gradle全部删除，注意main文件夹下的内容也要删除

3.在main下新建groovy文件夹

4.在groovy新建package，名字自己随意取，跟包名类似

5.在package下新建name.groovy文件，name自己取，如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
package com.sakurajiang.test

import org.gradle.api.Plugin
import org.gradle.api.Project

public class MyPlugin implements Plugin<Project> {
    void apply(Project project) {
        def log = project.logger
        log.error "========================";
        log.error "精简的MyPlugin，开始修改Class!";
        log.error "========================";
    }
}

6.在main目录下新建resources文件夹

7.在resources文件夹下新建META-INF文件夹

8.在META-INF文件夹下新建gradle-plugins文件夹

9.在gradle-plugins文件夹下新建name.properties文件，这里的文件名就是引用该插件时用到的名字。其中的内容是implementation-class=com.sakurajiang.test.MyPlugin，后面的值就是步骤5中的文件的包名加类名。

10.在该module的build.gradle文件中配置如下属性

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
apply plugin: 'groovy'
apply plugin: 'maven'
dependencies {
    compile gradleApi() //gradle sdk
    compile localGroovy() //groovy sdk
}
repositories {
    jcenter()
}

group='sakurajiang'
version='1.0.0'

uploadArchives {
    repositories {
        mavenDeployer {
            repository(url: uri('../repo'))
        }
    }
}

11.选择AS中右边的gradle，选择自定义的插件，选择upload中的uploadArchives

12.在需要使用该插件的module中的build中添加如下代码：

1
2
3
4
5
6
7
8
9
10
11
buildscript {
    repositories {
        maven {
            url uri('../repo')
        }
    }
    dependencies {
        classpath 'sakurajiang:buildsrc:1.0.0'
    }
}
apply plugin: 'Z'

其中’Z’就是步骤9中的name，其中的classpath就是group：modulename：version。

13.选择Make Project，至此就可以在Build中看到自定义插件中的信息了。自定义插件到此完成。