Android Wrapper Gradle 下载问题：Could not install Gradle distribution from...

问题与处理策略

问题描述

• 打开一个 Android 项目，报如下错误

Could not install Gradle distribution from 'https://services.gradle.org/distributions/gradle-5.4.1-all.zip'.
Reason: java.net.SocketTimeoutException: Read timed out

# 翻译

无法从 https://services.gradle.org/distributions/gradle-5.4.1-all.zip 安装 Gradle

原因：java.net.SocketTimeoutException 异常：超时

问题原因

• 由于网络问题导致 Gradle Wrapper 无法从官方服务器下载指定版本的 Gradle 分发包

处理策略

（1）修改 Gradle 下载地址

1. 修改 gradle-wrapper.properties 文件中的 distributionUrl，使用国内的镜像地址

# 原来是这样

distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-5.4.1-all.zip

# 修改为这样

distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-5.4.1-all.zip

2. 再次加载项目

（2）手动下载 Gradle

1. 访问下载地址，下载 Gradle 分发包

下载地址为 gradle-wrapper.properties 文件中的 distributionUrl

这里是: https://services.gradle.org/distributions/gradle-5.4.1-all.zip

注意删除 https 后面的斜杠（\）

2. 将下载的 ZIP 文件放到 Gradle Wrapper 的缓存目录中

缓存目录：【GRADLE_USER_HOME】\wrapper\dists\gradle-5.4.1-all\【随机字符串】

【随机字符串】是 Gradle Wrapper 生成的目录名

3. 再次加载项目