Gradle 包装器基础知识
Gradle官方推荐使用 Gradle Wrapper进行gradle项目的构建。
Wrapper 脚本调用声明的 Gradle 版本,并在必要时提前下载该版本。
Wrapper 以 gradlew 或 gradlew.bat 文件的形式提供。
Wrapper具有以下优势:
- 在给定的 Gradle 版本上对项目进行标准化。
- 为不同的用户配置相同的 Gradle 版本。
- 为不同的执行环境(IDE、CI 服务器等)配置 Gradle 版本。
使用 Gradle Wrapper
始终建议使用 Wrapper 执行构建,以确保可靠、受控和标准化地执行构建。
根据作系统,您可以运行 gradlew OR gradlew.bat 而不是 gradle 命令。(也就是说,如果使用gradle wrapper 进行gradle项目的构建,无需下载 gradle 二进制文件)
要在 Linux 或 OSX 计算机上运行 Wrapper,请执行以下操作:
./gradlew build
要在 Windows PowerShell 上运行包装器,请执行以下操作:
.\gradlew.bat build
该命令在 Wrapper 所在的同一目录中运行。 如果要在不同的目录中运行命令,则必须提供 Wrapper 的相对路径:
$ ../gradlew build
了解 Wrapper 文件
以下文件是 Gradle Wrapper 的一部分:
.
├── gradle
│ └── wrapper
│ ├── gradle-wrapper.jar
│ └── gradle-wrapper.properties
├── gradlew
└── gradlew.bat
- gradle-wrapper.jar:这是一个包含 Gradle Wrapper 代码的小 JAR 文件。它负责为项目下载和安装正确的 Gradle 版本(如果尚未安装)。
- gradle-wrapper.properties:此文件包含 Gradle Wrapper 的配置属性,例如分发 URL(从何处下载 Gradle)和分发类型(ZIP 或 TARBALL)。
- gradlew:这是一个 shell 脚本(基于 Unix 的系统),充当 .它用于在基于 Unix 的系统上执行 Gradle 任务,而无需手动安装 Gradle。gradle-wrapper.jar
- gradlew.bat:这是一个批处理脚本 (Windows),其用途与 Windows 系统相同,但在 Windows 系统上使用。gradlew
本片文章参考Gradle官方文档,原文地址:Gradle Wrapper Basics