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

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 217,277评论 6 503
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,689评论 3 393
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 163,624评论 0 353
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,356评论 1 293
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,402评论 6 392
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,292评论 1 301
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,135评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,992评论 0 275
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,429评论 1 314
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,636评论 3 334
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,785评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,492评论 5 345
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,092评论 3 328
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,723评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,858评论 1 269
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,891评论 2 370
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,713评论 2 354

推荐阅读更多精彩内容