Gradle之Wrapper详解

介绍

Wrapper,看到这个单词大家应该都不陌生,它就是位于Android项目根目录下的gradle文件夹中的gradle-wrapper.properties脚本文件。其实它就是对Gradle的一层包装,我们都知道一个Android的项目需要使用Gradle来构建,但是不同版本的项目需要不同版本的Gradle,而Wrapper简化了Gradle的部署,手动去部署的话就比较麻烦了,这里说得项目的版本指的是开发此项目所使用的Android Studio Gradle插件的版本,也就是我们通常所说的编译器的版本,而Android Studio Gradle插件和Gradle的版本对应关系如下:

所以,我们在导入别人的项目之前,要先根据自己的编译器版本去修改Gradle的版本,如果版本不对应会出现以下错误:

我的编译器版本为2.3.3,它所对应的Gradle版本最低为3.3,而当前我的项目的Gradle版本为2.14.1,那么显而易见项目就会构建失败,解决它很简单,只需要修改gradle-wrapper.properties文件中的distributionUrl字段即可,将2.14.1改为3.3,如图:

最后再重新build,这样Wrapper就会检查Gradle有没有被下载关联,如果没有就会从配置的地址(Gradle的官方地址)进行下载并运行构建。

生成Wrapper

我们创建一个新的项目,Gradle会自动为我们生成Wrapper所需的目录文件,其实在Gradle中内置了一个Wrapper task,如果我们要手动去生成Wrapper,只需要在项目的根目录下输入gradle wrapper即可,


生成的文件如下:

Wrapper 配置

我们在终端执行gradle wrapper生成相关文件时,可以为其指定一些参数,来控制Wrapper的生成,比如依赖的版本等,如下:

参数名 说明
--gradle-version 用于指定使用的Gradle版本
--gradle-distribution-url 用于指定下载Gradle发行版的url地址

使用方法为gradle wrapper --gradle-version 3.3,这样我们所配置的Wrapper就会使用3.3版本的Gradle,它会影响gradle-wrapper.properties中的distributionUrl的值,该值的规则是http\://services.gradle.org/distributions/gradle-${gradleVersion}-bin.zip
如果我们在执行gradle wrapper的时候不添加任何参数,那么就会使用你当前Gradle的版本作为生成的Wrappergradle version。例如,你当前安装的Gradle3.3版本的,那么生成的Wrapper也是3.3版本的。

gradle-wrapper.properties

该文件是wrapper的配置文件,我们上面执行任务的配置都会被写进此文件中。该文件的配置字段如下:

字段名 说明
distributionBase 下载的Gradle压缩包解压后存储的主目录
distributionPath 相对于distributionBase的解压后的Gradle压缩包的路径
zipStoreBase 同distributionBase,只不过是存放zip压缩包的
zipStorePath 同distributionPath,只不过是存放zip压缩包的
distributionUrl Gradle发行版压缩包的下载地址

distributionUrl就是我们gradle wrapper所依赖的Gradle版本。一般生成的都是这样的https://services.gradle.org/distributions/gradle-3.3-bin.zip通常都会把bin改成all,这样在开发过程中,就可以看到Gradle的源代码了。

自定义Wrapper Task

gradle-wrapper.properties是由Wrapper Task生成的,那么我们当然也可以自己来配置该Wrapper Task来达到我们配置gradle-wrapper.properties的目的,在build.gradle构建文件中录入如下脚本:

//构建wrapper
task wrapper(type: Wrapper){
   gradleVersion = '3.3'
}

然后我们执行gradle wrapper的时候,就会默认生成3.3版本的wrapper了,而不用使用--gradle-version 3.3进行了指定了。同样的你也可以配置其它参数,例如:

     //构建wrapper
task wrapper(type: Wrapper){
   gradleVersion = '3.3'
   archiveBase = 'GRADLE_USER_HOME'
   archivePath = 'wrapper/dists'
   distributionBase = 'GRADLE_USER_HOME'
   distributionPath = 'wrapper/dists'
   distributionUrl = 'http://services.gradle.org/distributions/gradle-3.3-all.zip'
}
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,547评论 6 477
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,399评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,428评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,599评论 1 274
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,612评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,577评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,941评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,603评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,852评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,605评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,693评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,375评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,955评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,936评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,172评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 43,970评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,414评论 2 342

推荐阅读更多精彩内容

  • 说明 本文主要介绍和Gradle关系密切、相对不容易理解的配置,偏重概念介绍。部分内容是Android特有的(例如...
    jzj1993阅读 15,557评论 1 62
  • https://www.jianshu.com/p/7c288a17cda8 总的来说,Android的系统体系结...
    燕京博士阅读 1,175评论 0 6
  • 是什么? 在语法上是基于Groovy语言的(Groovy 是一种基于JVM的敏捷开发语言,可以简单的理解为强类型语...
    千山万水迷了鹿阅读 99,447评论 4 122
  • Gradle对于很多开发者来说有一种既熟悉又陌生的感觉,他是离我们那么近,以至于我每天做项目都需要他,但是他又是离...
    阿_希爸阅读 9,566评论 10 199
  • 《念念许朝暮》文/郭乙朗 【文案】 十年相守,八年别离。 再见面时,她捧出一颗柔石般拳拳的心,她想将一生的念想都留...
    郭乙朗阅读 821评论 1 1