Gradle Wrapper 介绍

Gradle 能够为项目添加包装器。此包装器减轻了所有用户或持续集成系统安装 Gradle 的需要。它还可以防止版本问题,即项目使用的版本与用户安装的版本之间存在某些不兼容性。它通过在项目中本地安装 gradle 版本来实现。

该项目的用户只需运行:

> ./gradlew <task> # on *Nix or MacOSX
> gradlew <task>   # on Windows

要设置项目以使用包装器,开发人员:

  1. 执行:
gradle wrapper [--gradle-version 2.0]

如果 --gradle-version X 是可选的,如果没有提供(或者不包括包装器任务,如下所示),则使用的版本是正在使用的 gradle 版本。

  1. 要强制项目使用特定版本,请将以下内容添加到 build.gradle
task wrapper(type: Wrapper) {
    gradleVersion = '2.0'
}

运行 gradle wrapper 命令时,它会创建文件:

the_project/
  gradlew
  gradlew.bat
  gradle/wrapper/
    gradle-wrapper.jar
    gradle-wrapper.properties

有关此功能的官方文档位于 https://docs.gradle.org/current/userguide/gradle_wrapper.html