gradle-8.14-bin.zip 无法下载

5 阅读2分钟

方法一:使用国内镜像源(推荐)

这是最常用且高效的方法,通过切换到国内镜像服务器,可显著提升下载速度和成功率。

  1. 打开你的项目目录,找到 gradle/wrapper/gradle-wrapper.properties 文件。

  2. 找到 distributionUrl 这一行,将其内容修改为以下国内镜像地址之一:

    • 腾讯云镜像(推荐):
      distributionUrl=https://mirrors.cloud.tencent.com/gradle/gradle-8.14-bin.zip
    • 阿里云镜像:
      distributionUrl=https://mirrors.aliyun.com/gradle/gradle-8.14-bin.zip
    • 华为云镜像:
      distributionUrl=https://repo.huaweicloud.com/gradle/gradle-8.14-bin.zip
  3. 保存文件,并在 Android Studio 中点击 ‌Sync Project‌ 或重新构建项目。

方法二:手动下载并本地配置

如果镜像源仍无法下载,可以手动下载后放置到本地缓存目录。

  1. 手动下载: ‌ 访问 Gradle 官方发布页面 或 阿里云镜像仓库,下载 gradle-8.14-bin.zip 文件。
  2. 找到本地缓存目录: ‌ 默认情况下,Gradle 会将下载的分发包存放在 ~/.gradle/wrapper/dists/ 目录下(Windows 系统通常为 C:\Users<你的用户名>.gradle\wrapper\dists)。
  3. 定位并替换文件: ‌ 在 dists 目录下,找到一个以 gradle-8.14-bin 命名的文件夹(里面会有一串随机字符的子文件夹)。进入该子文件夹,‌删除其中的所有文件‌,然后将你手动下载的 gradle-8.14-bin.zip 文件复制粘贴到这里。
  4. 重启 IDE: ‌ 重启 Android Studio,项目同步时就会直接使用你本地提供的文件,无需再下载。

方法三:使用 gradle-all.zip 包(彻底解决源码下载问题)

有开发者反馈,即使配置了 bin.zip,IDE(如 IntelliJ IDEA)仍会尝试下载额外的源码包(gradle-src.zip),导致速度慢。使用 all.zip 包可以一劳永逸地解决此问题。

  1. 在 gradle-wrapper.properties 文件中,将 distributionUrl 修改为:
    distributionUrl=https://mirrors.cloud.tencent.com/gradle/gradle-8.14-all.zip
    (或使用阿里云、华为云的 all.zip 镜像)
  2. 重要提示: ‌ 如果你之前下载过 bin.zip 并放置在本地缓存目录,‌请先删除该目录下的所有文件‌,再放入 all.zip 包,否则 Gradle 会因校验和(checksum)不匹配而报错。
  3. 保存并同步项目。all.zip 包包含了二进制文件和源码,能避免 IDE 额外的网络请求。‌12