Gradle下载慢的问题很常见,主要原因是网络连接问题。以下是几种解决方案:
1. 修改Gradle版本(推荐)
在项目根目录的 gradle/wrapper/gradle-wrapper.properties 文件中:
properties
# 修改为国内镜像地址
distributionUrl=https://mirrors.cloud.tencent.com/gradle/gradle-8.13-bin.zip
# 或使用阿里云镜像
distributionUrl=https://mirrors.aliyun.com/gradle/gradle-8.13-bin.zip
2. 手动下载+本地配置
- 从官网或镜像站手动下载对应版本的Gradle
- 将zip文件放到指定目录:
- Windows:
C:\Users\你的用户名\.gradle\wrapper\dists\ - Mac/Linux:
~/.gradle/wrapper/dists/
- Windows:
- 无需解压,Android Studio会自动识别
3. 使用国内镜像配置(全面加速)
在项目根目录的 build.gradle 或 settings.gradle 中添加:
groovy
// settings.gradle
pluginManagement {
repositories {
maven { url 'https://maven.aliyun.com/repository/google' }
maven { url 'https://maven.aliyun.com/repository/central' }
maven { url 'https://maven.aliyun.com/repository/gradle-plugin' }
google()
mavenCentral()
gradlePluginPortal()
}
}
dependencyResolutionManagement {
repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
repositories {
maven { url 'https://maven.aliyun.com/repository/google' }
maven { url 'https://maven.aliyun.com/repository/central' }
maven { url 'https://maven.aliyun.com/repository/public' }
google()
mavenCentral()
}
}
4. 代理设置
如果公司网络需要代理,在 gradle.properties 中添加:
properties
systemProp.http.proxyHost=127.0.0.1
systemProp.http.proxyPort=7890
systemProp.https.proxyHost=127.0.0.1
systemProp.https.proxyPort=7890
5. 使用离线模式
- 下载完整的Gradle发行版:https://gradle.org/releases/
- 在Android Studio设置中:
- File → Settings → Build, Execution, Deployment → Build Tools → Gradle
- 选择"Use local gradle distribution"
- 指定解压后的目录
常用镜像地址:
- 腾讯云:
https://mirrors.cloud.tencent.com/gradle/ - 阿里云:
https://mirrors.aliyun.com/gradle/ - 华为云:
https://mirrors.huaweicloud.com/gradle/
快速解决方案:
最快捷的方法 :直接修改 gradle-wrapper.properties 中的distributionUrl为阿里云或腾讯云镜像地址,然后重新同步项目。
完成后记得清理缓存:File → Invalidate Caches and Restart