android - 什么是 gradle wrapper 和 gradlew.bat 文件？

Question

最近我开始了解 Gradle 作为构建系统的强大功能，作为一名 Android 开发人员，我想深入了解它。

One article说了以下内容:

You can execute all the build tasks available to your Android project using the Gradle wrapper command line tool. It's available as a batch file for Windows (gradlew.bat) and a shell script for Linux and Mac (gradlew.sh), and it's accessible from the root of each project you create with Android Studio.

To run a task with the wrapper, use one of the following commands:

• On Windows:

  gradlew task-name
  

现在我有一些疑惑，如下:

1. 什么是 Gradle Wrapper 和 gradlew.bat？
2. 如果我安装了 Android Studio 并且它使用 gradle 来构建我的应用程序(所以 gradle 已经安装在我的系统上)，我是否还需要安装 gradle 以从命令行构建目的？当我在命令行上写任何像 gradle, gradlew 这样的命令时，我收到错误消息说 gradlew is not recognized as internal or external command (其他命令同样的错误)。我可能在错误的路径上使用它，请帮助我了解我需要在什么路径上使用 Gradle 相关命令？
3. 如果我需要下载并安装它，如何以及在哪里可以找到该文件？其他流程呢？

我为此使用 Windows 机器。

Answer 1

Gradle Wrapper 是 Gradle 构建系统的可选部分。它由您 checkin 版本控制系统的四个文件组成。 Unix 启动脚本 <your root project>/gradlew , <your root project>/gradlew.bat Windows 启动脚本，<your root project>/gradle/wrapper/gradle-wrapper.jar它包含包装器的类文件，由启动脚本和 <your root project>/gradle/wrapper/gradle-wrapper.properties 启动。其中包含包装器的一些配置，例如用于构建项目的 Gradle 版本。

在我看来，每个 Gradle 项目，即使是最小的项目，都应该使用 Gradle 包装器。

Gradle wrapper 确保您的构建始终使用相同的 Gradle 版本运行，无论谁执行构建，在何处安装 Gradle 或未安装 Gradle，只要使用 Gradle wrapper 构建项目即可。这意味着您可以为该 Gradle 版本设计您的构建，并确保构建不会失败，只是因为有人使用不同版本的 Gradle，因此这也是构建可重复性的重要一步。

此外，希望构建您的项目的人只需要安装 Java，仅此而已。他不需要安装任何 Gradle 版本。实际上任何已经安装的 Gradle 版本都会被忽略。 Gradle 包装器检查是否在 ~/.gradle/ 中构建所需的版本已经存在，因为任何项目的一些 Gradle 包装器已经把它放在那里了。如果已经存在，则使用它，否则自动下载。

如果您输入 gradlew在命令行上并且找不到命令，这意味着您没有将根项目路径放入 PATH 环境变量(我也不建议这样做)，您当前也不在根项目的目录中。要运行 Gradle 构建，您必须在项目中的任何位置调用 Gradle 或 Gradle 包装器。但是就像任何不在路径上的可执行文件一样，您当然必须提供它的路径。所以如果你在你的根项目目录中，你可以简单地做 gradlew .如果你在 <root project dir>/foo/bar/ ，您需要调用 ../../gradlew .

Gradle Wrapper 文件由隐式可用的 Gradle 任务生成 wrapper然后检查相关项目的 VCS。如果项目不存在这四个文件，则它不使用 Gradle 包装器，您应该向项目发布改进请求以添加它。

如果某些项目不使用 Gradle 包装器，而是使用 Gradle 构建，您可以安装 Gradle 并使用 gradle而不是 gradlew ，或者您甚至可以调用磁盘上可用的任何其他项目的 Gradle 包装器。然后构建将使用包装器或 Gradle 安装正在使用的 Gradle 版本运行，因此可能不会按预期运行，这就是为什么每个项目如果使用 Gradle 都应该使用包装器。