安装

从官网下载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