安装
从官网下载zip压缩包文件
此文件中包含如下内容:
gradle执行文件
用户手册(HTML & PDF)
DSL参考手册
API文档(Javadoc & Groovydoc)
用户手册中的示例代码,其中有一些可以在你自己的项目中直接使用
源代码(仅供参考,如果你想编译源代码,需要从源代码仓库下载源代码)
设置环境变量
添加GRADLE_HOME环境变量,其值为上一步解压出来的文件夹所在目录
添加GRADLE_HOME/bin到PATH环境变量
测试安装
在命令行中执行 gradle -v
查看输出内容
JVM参数
可以通过环境变量GRADLE_OPTS或JAVA_OPTS给Gradle设置参数。也可以在gradle或gradlew脚本的开始处设置环境变量。
目前还不能通过命令行参数给gradle设置JVM参数。
执行多个任务
在gradle
命令后跟随多个任务的名称就可以一次执行多个任务。如果任务之间存在依赖关系,相同名称的任务只会执行一次。如:执行gradle dist test
,dist 依赖test,test只会执行一次。
排除任务
使用命令行参数-x
可以排除指定名称的任务。如:执行gradle dist -x test
,将不会执行test和test依赖的任务,虽然test依赖了compileTest,也不会执行compileTest任务。
在发生错误时继续构建
默认情况下,gradle在任务发生错误时会退出执行,这会让构建工作尽快完成,不过这样也隐藏了可能会发生的其它错误。为了在一次构建中查看尽可能多的错误,你可以使用--continue
选项,所有的错误信息会在构建结束时输出。
任务名缩写
在命令行中指定任务名称时,可以不用给出完整的任务名称,只需要给出能唯一确定任务名称的部分名称即可。
如:gradle dist
可以缩写为gradle di
也可以按驼峰命名法给出首字母缩写,如:gradle compileTest
可以缩写为gradle compTest
或gradle cT
在-x
选项中也可以使用名称缩写
指定构建文件
执行gradle命令时,默认在当前目录中查找构建文件。可以使用-b
选项来使用指定的构建文件,当使用-b
选项时,settings.gradle
选项不起作用。
如:gradle -q -b subdir/myproject.gradle hello
另外,可以使用-p
选项来指定项目目录。在多项目构建中,需要使用-p
选项来代替-b
选项。
如:gradle -q -p subdir hello
使用subdir目录中的build.gradle文件。
强制执行任务
gradle使用增量构建,当一个任务的输入输出自上次构建后没有变化时,就不会再执行此任务,并且在下一次执行构建时在任务名称的后面显示UP-TO-DATE
。
如果你想强制执行一个任务,使用--rerun-tasks
选项即可,如:gradle --rerun-tasks doIt
这会强制执行所有需要的任务,而不仅仅是在命令行中指定的任务。
获取关于构建的信息
gradle提供了一些内置的任务来显示构建的详细信息。这对于理解构建的结构和依赖很有帮助,也有助于调试问题。
显示项目列表
gradle projects
显示指定项目的子项目列表。
显示任务列表
gradle tasks
可以显示主要的任务,gradle tasks --all
可以显示全部的任务。
显示任务详情
显示指定任务的详细信息。
如:gradle help -task taskname
显示项目依赖
以树形显示指定项目的依赖关系。
如:gradle -q dependencies api:dependencies webapp:dependencies
显示项目构建脚本的依赖
gradle buildEnvironment
查看指定依赖的详情
gradle dependencyInsight
查看指定依赖的详情
如:gradle -q webapp:dependencyInsight --dependency groovy --configuration compile
查看项目属性
gradle properties
显示项目的属性列表。
如:gradle -q api:properties
虚执行
-m
选项并不会真正的执行构建,只是显示构建的顺序。
如:gradle -m test