1. 安装前检查
Gradle 依赖 JDK, 检查 JDK 是否已经安装
2. 安装 Gradle
2.1 下载 Gradle
https://services.gradle.org/distributions/
2.2 设置 Gradle 环境变量
windows 下安装
环境变量中增加名为
GRADLE_HOME
的变量名,值为 Gralde 的解压路径,例如: E:\GradleGRADLE_HOME = E:\Develop\OpenSource\gradle-6.5.1-all
在path的后追加 %GRADLE_HOME%\bin
;
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. 参考
- 《实战Gradle 中文版》