2.Gradle安装和常用命令

1. 安装前检查

Gradle 依赖 JDK， 检查 JDK 是否已经安装

2. 安装 Gradle

2.1 下载 Gradle

https://gradle.org/releases/

https://services.gradle.org/distributions/

2.2 设置 Gradle 环境变量

1. windows 下安装

   环境变量中增加名为 GRADLE_HOME 的变量名，值为 Gralde 的解压路径，例如： E:\Gradle

   GRADLE_HOME = E:\Develop\OpenSource\gradle-6.5.1-all

   

   在path的后追加 %GRADLE_HOME%\bin；

   

2. linux 下安装

   export GRADLE_HOME=/opt/gradle
   export PATH=$PATH:$GRADLE_HOME/bin
   

2.3 验证 Gradle 是否安装成功

使用 gradle -v 命令查看 Gradle 版本信息

2.4 修改默认缓存目录

gradle 默认缓存目录在 C:\Users\{user}\.gradle 目录下，类似 maven 默认的 .m2 目录，可以把它修改为其他地方

使用命令 [gradle -g 目录路径] 进行修改，例如 gradle -g E:\gradle\repository

3. hello world

新建 build.gradle 文件，内容如下

task helloWorld {
	doLast {
		println 'hello World'
	}
}

这里新建了一个 task，它只有一个操作，就是 doLast，在调用 doLast 的时候打印 “hello World”，这里的 println 就相当于 java 中的 System.out.println；

使用 gradle -q helloWorld 命令运行 task，输出 hello world

4. 常用命令

4.1 列出所有task

gradle -q tasks

使用 --all 参数查看详细信息

gradle -q tasks --all

4.2 执行 task

有如下脚本文件 build.gradle，定义了几个task

// 定义一个任务 startSession
task startSession {
    doLast {
        chant()
    }
}

// 定义一个 chant 方法
def chant() {
    ant.echo 'Repeat after me...'
}

// 生成3个任务，分别是 yayGradle0，yayGradle1，yayGradle2
3.times {
    task "yayGradle$it" {
        doLast {
            println 'Gradle rocks'
        }
    }
}

// dependsOn 表示依赖关系，yayGradle0 的执行依赖于 startSession
yayGradle0.dependsOn startSession
yayGradle2.dependsOn yayGradle1, yayGradle0
// groupTherapy 执行依赖于 yayGradle2
task groupTherapy(dependsOn: yayGradle2)

使用 gradle yayGradle0 groupTherapy 来进行调用，输出如下结果：

gradle yayGradle0 groupTherapy

结合输入结果和脚本，可以得到如下执行顺序：

如果要排除一个任务，可以使用 -x 参数

# 排除 yayGradle0
gradle groupTherapy -x yayGradle0 

4.3 命令行参数

部分参数

-?, -h, --help                     显示帮助信息.
-b, --build-file                   默认构建文件是 build.gradle，可以使用该参数指定其他文件.
--build-cache                      开启构建缓存
-c, --settings-file                指定设置文件，默认是 settings.gradle.
--continue                         中间任务失败也继续执行.
-D, --system-prop                  通过JVM的方式指定系统参数 (e.g. -Dmyprop=myvalue).
-d, --debug                        以debug方式打印日志.
--daemon                           使用Gradle守护进行执行构建
-g, --gradle-user-home             指定Gradle的默认目录 user home
-I, --init-script                  指定初始化脚本.
-i, --info                         指定日志级别.
--no-build-cache                   关闭构建缓存.
-P, --project-prop                 指定参数，可以使用-P向构建脚本传参 (e.g -Pmyprop=myvalue).
-p, --project-dir                  指定脚本运行目录，默认当前目录
-q, --quiet                        只打印error日志.
-v, --version                      打印版本信息.
-w, --warn                         日志界别设置为 warn.
-x, --exclude-task                 在构建过程中排除某个任务.

5. 参考

1. 《实战Gradle 中文版》