Gradle 包装器拒绝下载和使用 6.7.1 版

如何解决Gradle 包装器拒绝下载和使用 6.7.1 版

我在我的系统 (Mac) 上运行 Gradle 6.2.2，我需要它为我在本地运行的一些关键项目保持在 6.2.2 上。

我刚刚克隆了另一个项目，该项目由其他使用 Gradle 6.7.1 的开发人员维护。这是一个 Spring Boot 应用程序。当我在命令行上运行它的任何 Gradle 命令时，我得到：

> Failed to apply plugin [id 'org.springframework.boot']
   > Spring Boot plugin requires Gradle 5 (5.6.x only) or Gradle 6 (6.3 or later). The current version is Gradle 6.2.2

所以 看起来 Spring Boot 希望我使用 Gradle 6.3+。

我对 Gradle Wrapper 的理解（如果我错了，请纠正我）是：

1. 您使用 build.gradle 指令修改 wrapper，指定用于项目的 Gradle 版本
2. 然后您在命令行上运行 gradle wrapper，Gradle 会为您下载和缓存（某处）该版本的 Gradle
3. 现在您可以运行普通的 Gradle 命令，但您使用的是 gradle 而不是 gradlew，这告诉 Gradle 使用包装指令中指定的 Gradle 版本

如果有任何不正确或误导，请首先纠正我！假设它或多或少是正确的...

我在项目的 build.gradle 中添加了以下指令：

wrapper{
    gradLeversion = '6.7.1'
    distributionType = Wrapper.distributionType.BIN
}

我的希望是，虽然我在系统上本地使用 6.2.2，但这会告诉 Gradle 获取和使用 Gradle v6.7.1，我们知道它与项目的其余部分兼容。

然后我在命令行上从项目根目录运行 gradle wrapper：

$ gradle wrapper

FAILURE: Build Failed with an exception.

* Where:
Build file '/Users/myuser/workspace/the-new-project/build.gradle' line: 27

* What went wrong:
An exception occurred applying plugin request [id: 'org.springframework.boot',version: '2.3.2.RELEASE']
> Failed to apply plugin [id 'org.springframework.boot']
   > Spring Boot plugin requires Gradle 5 (5.6.x only) or Gradle 6 (6.3 or later). The current version is Gradle 6.2.2

* Try:
Run with --stacktrace option to get the stack trace. Run with --info or --debug option to get more log output. Run with --scan to get full insights.

* Get more help at https://help.gradle.org

BUILD Failed in 702ms

对这里发生的事情有什么想法吗？我如何告诉 Gradle 下载和使用 6.7.1 但不接触我的 6.2.2 本地版本？

解决方法

您对包装器的理解是正确的（尽管对于第 1 点，您也可以在命令行中指定版本和类型，或者通过省略它们来依赖默认值）。

如果项目尚未使用包装器脚本（项目根目录中没有 gradlew 文件），您需要手动 download 兼容版本的发行版。使用它来生成包装脚本，然后从那时起，始终使用 gradlew 来构建项目。如果您愿意，您可以在之后删除手动下载的文件。这不会影响您自己安装的旧版本。

如果实际上已经有一个包装脚本，但它被配置为不兼容的版本，那么只需手动更改文件 gradle/wrapper/gradle-wrapper.properties 中的版本。请务必在之后运行 wrapper 任务以获取实际脚本的更新（如果有）。

您还应该考虑将包装器用于需要旧版本 6.2.2 的您自己的项目。这样您就不必担心将本地安装的发行版保持在正确的版本中并在它们之间手动切换。