Gradle使用手册

安装

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

你可能感兴趣的:(Gradle使用手册)