Gradle version 与 plugin version以及 gradle-wrapper.properities对应关系

本文介绍了 Android Gradle 插件与 Gradle 版本之间的兼容性要求。为了确保项目的最佳性能,请使用最新版本的 Android Gradle 插件和 Gradle。文中提供了不同版本的 Android Gradle 插件所需的 Gradle 最低版本。

android studio user guide

https://developer.android.com/studio/releases/gradle-plugin.html#revisions


对应关系:Plugin vesion指的是在AS中作为plugin的version, Gradle Version 指的是其本身的version , distributionUrl 填入其本身的version

When you update Android Studio, you may receive a prompt to also update Gradle to the latest available version. You can choose to accept the update or manually specify a version based on your project's build requirements.

The following table lists which version of Gradle is required for each version of the Android plugin for Gradle. For the best performance, you should use the latest possible version of both Gradle and the Android plugin.

Plugin versionRequired Gradle version
1.0.0 - 1.1.32.2.1 - 2.3
1.2.0 - 1.3.12.2.1 - 2.9
1.5.02.2.1 - 2.13
2.0.0 - 2.1.22.10 - 2.13
2.1.3 - 2.2.32.14.1+
2.3.0+3.3+

You can specify the Gradle version in either the File > Project Structure > Project menu in Android Studio, or by editing the Gradle distribution reference in thegradle/wrapper/gradle-wrapper.properties file. The following example sets the Gradle version to 3.3 in thegradle-wrapper.properties file.

...
distributionUrl = https\://services.gradle.org/distributions/gradle-3.3-all.zip
...


### 如何下载 gradle-wrapper.jar 文件 gradle-wrapper.jar 文件是 Gradle Wrapper 的核心组件之一,通常位于项目的 `gradle/wrapper/` 目录下。如果需要手动获取该文件,可以通过以下方法完成。 #### 方法一:从现有项目中提取 如果有一个已经配置好的 Gradle 项目,可以直接从该项目中复制 gradle-wrapper.jar 文件。其默认路径为: ``` <项目根目录>/gradle/wrapper/gradle-wrapper.jar ``` 确保目标项目是一个正常的 Gradle 项目,并且包含完整的 Wrapper 配置[^1]。 #### 方法二:通过官方或镜像站点下载 Gradle Wrapper 的 jar 文件本身并不直接提供下载链接,但可以通过创建一个新的 Gradle 项目来生成它。以下是具体步骤: 1. 创建一个新的空目录作为项目根目录。 2. 在该目录下运行以下命令以初始化一个 Gradle 项目: ```bash gradle wrapper ``` 此命令会自动生成 `gradle/wrapper/gradle-wrapper.jar` 文件以及相关的配置文件(如 `gradle-wrapper.properties`)[^4]。 3. 如果网络环境无法访问默认的 Gradle 分发地址,可以修改 `gradle-wrapper.properties` 文件中的 `distributionUrl` 属性,使用国内镜像源。例如: ```properties distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-7.5.1-bin.zip ``` 这样可以加速下载并避免因网络问题导致的失败[^3]。 #### 方法三:直接从 Gradle 发布版本中提取 如果无法通过上述方法获取 gradle-wrapper.jar 文件,也可以从 Gradle 的官方发布版本中手动提取。以下是操作步骤: 1. 访问 Gradle 官方下载页面或镜像站点,下载所需的 Gradle 版本。例如: ``` https://services.gradle.org/distributions/gradle-7.5.1-bin.zip ``` 或者使用腾讯云镜像: ``` https://mirrors.cloud.tencent.com/gradle/gradle-7.5.1-bin.zip ``` 2. 解压下载的压缩包后,在 `bin` 目录下找到 `gradle-wrapper.jar` 文件并复制到目标位置。 #### 注意事项 - 确保使用的 Gradle 版本项目需求一致。例如,如果项目要求 Gradle 7.5.1,则必须下载对应版本的文件[^2]。 - 如果在运行过程中遇到“无法找到或加载主类 org.gradle.wrapper.GradleWrapperMain”的错误,可能是由于 `gradle-wrapper.jar` 文件损坏或配置不正确引起的。请检查文件完整性和配置文件内容。 ```python # 示例代码:检查 gradle-wrapper.jar 是否存在 import os wrapper_path = 'gradle/wrapper/gradle-wrapper.jar' if os.path.exists(wrapper_path): print("gradle-wrapper.jar 文件已找到") else: print("gradle-wrapper.jar 文件不存在,请重新下载") ```
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值