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