fix-gradle-download.md 2.2 KB
Gradle 下载超时解决方案
如果遇到 Gradle 下载超时，可以使用以下方法：
方法一：增加超时时间（已自动配置）
已更新 gradle-wrapper.properties，将超时时间从 10 秒增加到 60 秒。
方法二：使用国内镜像源
步骤 1: 替换 Gradle Wrapper 配置
编辑 android/gradle/wrapper/gradle-wrapper.properties，将：
distributionUrl=https\://services.gradle.org/distributions/gradle-8.11.1-all.zip
替换为以下任一镜像：
腾讯云镜像：
distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-8.11.1-all.zip
阿里云镜像：
distributionUrl=https\://mirrors.aliyun.com/gradle/gradle-8.11.1-all.zip
步骤 2: 重新运行构建
cd android
gradlew.bat assembleDebug
方法三：手动下载 Gradle
步骤 1: 下载 Gradle
从以下地址下载 gradle-8.11.1-all.zip：
- 官方：https://services.gradle.org/distributions/gradle-8.11.1-all.zip
- 腾讯云：https://mirrors.cloud.tencent.com/gradle/gradle-8.11.1-all.zip
- 阿里云：https://mirrors.aliyun.com/gradle/gradle-8.11.1-all.zip
步骤 2: 放置到缓存目录
将下载的 zip 文件放到：
%USERPROFILE%\.gradle\wrapper\dists\gradle-8.11.1-all\<随机字符串>\gradle-8.11.1-all.zip
注意：<随机字符串> 目录会在首次运行时创建，可以先运行一次 gradlew.bat 查看目录名。
步骤 3: 重新运行构建
cd android
gradlew.bat assembleDebug
方法四：使用代理
如果有代理，可以配置 Gradle 使用代理：
创建或编辑 android/gradle.properties，添加：
systemProp.http.proxyHost=127.0.0.1
systemProp.http.proxyPort=7890
systemProp.https.proxyHost=127.0.0.1
systemProp.https.proxyPort=7890
根据您的代理设置调整端口号。
方法五：使用已安装的 Gradle（如果已安装）
如果系统已安装 Gradle，可以设置环境变量：
# Windows PowerShell
$env:GRADLE_HOME="C:\path\to\gradle"
$env:PATH="$env:GRADLE_HOME\bin;$env:PATH"
# 然后直接使用 gradle 命令
cd android
gradle assembleDebug
推荐方案
推荐使用方法二（国内镜像），速度最快且稳定。