Skip to content

Latest commit

 

History

History
77 lines (51 loc) · 2.02 KB

gradle_wrapper.md

File metadata and controls

77 lines (51 loc) · 2.02 KB
Raw

Gradle Wrapper

Wrapper的好处

Gradle推荐使用包装器（Wrapper）的方式来执行构建任务，这样的好处是：

  • 在开发或部署的时候，不需要提前准备Gradle环境
  • Wrapper指定了Gradle的版本，不需要再担心版本兼容问题

安装Wrapper

可以通过Gradle内置的wrapper任务来添加Gradle Wrapper，详见官方文档，步骤如下：

  1. 执行wrapper任务生成包装器文件（需要系统已安装Gradle）

    $ gradle wrapper

    注意：

    • 默认情况下，会使用和系统Gradle相同的版本
    • Gradle Wrapper默认类型为bin，即没有样例代码和文档

    当然还可以指定版本和类型：

    $ gradle wrapper --gradle-version 7.5 --distribution-type bin|all

  2. 生成包装器

    ├── gradle
│   └── wrapper
│       ├── gradle-wrapper.jar
│       └── gradle-wrapper.properties
├── gradlew
└── gradlew.bat

    其中：

    • gradle/wrapper/gradle-wrapper.properties中存储了Gradle的版本信息

  3. 验证

    $ ./gradlew --version

------------------------------------------------------------
Gradle 7.5
------------------------------------------------------------

Build time:   2022-07-14 12:48:15 UTC
Revision:     c7db7b958189ad2b0c1472b6fe663e6d654a5103

Kotlin:       1.6.21
Groovy:       3.0.10
Ant:          Apache Ant(TM) version 1.10.11 compiled on July 10 2021
JVM:          1.8.0_211 (Oracle Corporation 25.211-b12)
OS:           Mac OS X 10.16 x86_64

注意：

  • 下载下来的包装器文件应该提交到版本控制系统中（故 .gitignore不应该忽略所有Jar文件）

  • 第一次使用./gralew将会在此地址下载此文件：

    ~/.gradle/wrapper/dists/gradle-7.5-bin

References

  1. Gradle官方文档：The Gradle Wrapper