Gradle Wrapper

Posted ~风铃~

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Gradle Wrapper相关的知识,希望对你有一定的参考价值。

Gradle Wrapper

当把本地一个项目放入到远程版本库的时候,如果这个项目是以gradle构建的,那么其他人从远程仓库拉取代码之后如果本地没有安装过gradle会无法编译运行,如果对gradle不熟悉,会使得无法很好的去快速构建项目代码。所以gradle可以自动生成一键运行的脚本,把这些一起上传远程仓库,使得即使没有安装gradle也可以自动去安装并且编译项目代码。

  • Gradle是个构建系统,能够简化你的编译、打包、测试过程。熟悉Java的同学,可以把Gradle类比成Maven。
  • Gradle Wrapper的作用是简化Gradle本身的安装、部署。不同版本的项目可能需要不同版本的Gradle,手工部署的话比较麻烦,而且可能产生冲突,所以需要Gradle Wrapper帮你搞定这些事情。Gradle Wrapper是Gradle项目的一部分。

简单的gradle wrapper生成

【gradle wrapper生成】

我们在新建的目录下使用命令行输入gradle wrapper命令:

 
技术图片
 

在新建的目录下可以看到以下文件:

 
技术图片
 
 
技术图片
 

【gradle wrapper文件说明】

|____gradle
| |____wrapper
| | |____gradle-wrapper.jar  //具体业务逻辑
| | |____gradle-wrapper.properties  //配置文件
|____gradlew  //Linux 下可执行脚本
|____gradlew.bat  //Windows 下可执行脚本

(1)gradlew.bat

gradlew.bat是bat 脚本,Windows 用户可以通过它执行 Gradle 任务,配合gradle文件夹使用。

而Linux使用的是gradlewgradlew是一个shell 脚本,Unix 用户可以通过它来执行 Gradle 任务。

(2)gradle-wrapper.jar

gradle-wrapper.jar是Gradle Wrapper的主体功能包(wrapper 的代码所在)。项目打包必须要有的,不然无法去执行gradlew。

(3)gradle-wrapper.properties

gradle-wrapper.properties文件主要指定了该项目需要什么版本的Gradle,从哪里下载该版本的Gradle,下载下来放到哪里。从图示项目中可以知道我要使用gradle-3.5版本。

 
技术图片
 

我们使用gradlew命令的使用,会根据这个文件来使用对应的gradle进行构建。当本地GRADLE_USER_HOME(当前用户目录,一般指~/.gradle)中的~/.gradle/wrapper/dists没有安装gradle时,将会自动从此地址distributionUrl中下载gradle,之后的执行将不会再次下载安装。

【文件如何配合使用】

当从版本库下载代码之后,如果你本机安装过gradle,当然直接直接编译运行既可。但是对没有安装gradle的用户,可以执行项目根目录下的gradlew.bat脚本(Linux是执行gradlew命令)

将会在gradle-wrapper.properties中的~/.gradle/wrapper/dists目录中首次下载并安装gradle并可以编译代码,一个指令可以下载并安装gradle来构建项目,由此可见非常方便。大概流程如下:

  1. 解析gradle-wrapper.properties文件,获取项目需要的 gradle 版本下载地址。
  2. 判断本地用户目录下的~/.gradle目录下是否存在该版本,不存在该版本,走第3点,存在走第4点。
  3. 下载gradle-wrapper.properties指定版本,并解压到用户目录的下 ~/.gradle文件下。
  4. 利用 ~/.gradle目录下对应的版本的 gradle 进行相应自动编译操作。

将Wrapper添加到Gradle项目

在命令行中运行 wrappertask 即可配置Wrapper,如下:

$gradle wrapper --gradle-version 2.8
:wrapper
BUILD SUCCESSFUL
Total time: 3.546 secs

 

运行完毕后,可以看到在项目的更目录中多了上面提到的一些文件和目录:

 
技术图片
 

除了直接在命令行执行外,也可以在build.gradle文件中添加一个Wrapper task:

task wrapper(type: Wrapper){  // type: Wrapper中的Wrapper开头W必须大写
 gradleVersion=‘2.8‘
 distributionBase=‘GRADLE_USER_HOME‘
 distributionPath=‘wrapper/dists‘
 zipStoreBase=‘GRADLE_USER_HOME‘
 zipStorePath=‘wrapper/dists‘
 distributionUrl=https://services.gradle.org/distributions/gradle-2.8-all.zip
}

 


//每一项都可单独设置,gradle-2.8-all.zip表示下载该版本Gradle的源码

然后执行这个task:

gradle -q wrapper

 







以上是关于Gradle Wrapper的主要内容,如果未能解决你的问题,请参考以下文章

Wrapper 包装器

Chapter 5. The Gradle Wrapper 关于gradle wrapper

Android Gradle 插件Gradle 基础配置 ③ ( 生成 Gradle Wrapper 配置 | 分析生成的 gradle-wrapper.properties 配置文件 )

2018-06-26 IDEA 如何升级gradle wrapper

Gradle Wrapper

Android Gradle 插件Gradle 基础配置 ⑤ ( gradle-wrapper.properties 配置分析 | GRADLE_USER_HOME 目录 )