解决 Gradle 无法正常下载 的错误(Android Studio)

5,985 阅读2分钟

小知识,大挑战!本文正在参与“程序员必备小知识”创作活动。

解决 Gradle 无法正常下载 的错误(Android Studio)

在使用 Android Studio 开发项目时,一般使用 gradle 管理依赖。
但在国内,gradle 的自动下载经常会中途断开。
最初是尝试 重复让 Android Studio 自动下载,以为多试几次会解决问题,然并卵。

后来发现可以手动在 gradle 的官网上下载工程对应版本的 gradle 后,再放到本地对应的目录下,就可以解决问题。

具体操作

  1. 确认要下载的 gradle 版本

    Android Studio 会根据 {Project}/gradle/wrapper/gradle-wrapper.properties 里指定的版本下载 gradle.

    gradle-wrapper.properties

    #Sat Oct 16 16:58:20 CST 2021
    distributionBase=GRADLE_USER_HOME
    distributionUrl=https://services.gradle.org/distributions/gradle-6.7.1-bin.zip
    distributionPath=wrapper/dists
    zipStorePath=wrapper/dists
    zipStoreBase=GRADLE_USER_HOME
    
  2. 去 gradle 的官方网站下载

    Gradle 的所有发布的版本的下载地址: Gradle Distributions

    本文例中 gradle-wrapper.properties 指定的是 gradle-6.7.1-bin.zip,所以需要在 gradle 的官方网站下载 gradle-6.7.1-bin.zip。

    下载时需要根据 gradle-wrapper.properties 指定的 gradle 版本下载,不然不起作用。

  3. 将下载的 gradle 压缩文件放到本地 gradle 所在目录。

    找到本地 gradle 所在目录,将下载的 gradle 文件放进去即可。

    Mac 下 gradle 所在目录是在用户目录下,因为默认是隐藏文件,所以看不到。 Command+Shift+. 可以切换显示隐藏目录和隐藏文件。
    Windows 下 gradle 在用户目录下。

    Mac 的 gradle 目录例:

    /Users/BS/.gradle/
    

    Windows 的 gradle 目录例:

    C:\Users\BS\.gradle
    

    进入到 gradle 目录下 wrapper/dists 下,会发现 对应的 gradle 版本的目录,这里是 gradle-6.7.1-bin。进入到这个目录后,会发现一个凌乱的由无规则的字母数字组成的,类似 UUID 的目录,把下载的 gradle 压缩文件放到这个凌乱的目录里即可。不需要解压,Android Studio 会自动解压。

    Mac 下 gradle 压缩文件的放置位置例(Windows 相似,不再列出):

    /Users/BS/.gradle/wrapper/dists/gradle-6.7.1-bin/bwlcbys1h7rz3272sye1xwiv6
    

    大功告成!
    可以用 Android Studio 愉快地进行 gradle 的依赖管理了。