usky-human/web/fix-gradle-download.md

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

推荐方案

推荐使用方法二（国内镜像），速度最快且稳定。