Gradle 下载失败解决方案
在构建安卓项目时,Gradle 下载失败是一个常见问题。这通常发生在项目构建的第一步,当检查到没有本地 Gradle 时,系统会尝试从官网下载 Gradle。但是,由于 Gradle 官网在国外,导致 Android Studio 默认的下载地址经常会失败或者超时。
常见错误提示
Download xxxx/gradle-x.x.x.zip 失败
Read time out
解决方案
我们可以通过修改 gradle-wrapper.properties
文件,将下载地址替换为国内镜像站点来解决这个问题。
步骤
-
找到
gradle-wrapper.properties
文件
该文件的路径通常如下图所示:
-
修改下载地址
找到文件中类似如下内容的部分:distributionUrl=https\://services.gradle.org/distributions/gradle-x.x.x-all.zip
将
distributionUrl
替换为腾讯云的镜像地址,修改后的内容如下:distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-x.x.x-all.zip
注意:请保持
gradle-x.x.x
的版本号不变,只需替换域名部分。(ps:完整地址为腾讯Gradle镜像地址) -
保存并重试构建
保存文件后,重新进行项目构建,应该可以正常下载 Gradle。
示例
以下是一个完整的示例:
原始内容:
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-6.5-all.zip
修改后的内容:
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-6.5-all.zip
这样,通过将 Gradle 下载地址更改为腾讯云的镜像地址,可以有效解决下载失败的问题,确保项目构建顺利进行。