Android Studio 打开项目慢的问题

Android Studio 卡在 Building ‘xxx’

Android Studio 打开一个 Android 项目目录时,它调用 Gradle 工具来编译项目,相当于在项目目录下运行 ./gradlew 命令(Windows 上则是运行 gradlew.bat)。

gradlew 就是 Gradle Wrapper 的缩写,gradlew 命令在执行时会下载配置文件 <ProjectDir>/gradle/wrapper/gradle-wrapper.propertiesdistributionUrl 指定的 Gradle 版本, gradle-wrapper.properties 文件内容如下:

#Sat Jun 24 21:38:23 PDT 2017
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
#distributionUrl=https\://services.gradle.org/distributions/gradle-4.0-rc-1-all.zip

distributionUrl=http\://127.0.0.1:8080/gradle-4.0-rc-1-all.zip

在国内访问 services.gradle.org 是很慢的,所以会一直在下载 gradle-xxx.zip 文件,不信请在项目目录下执行 gradlew 命令。

解决办法

让 Gradle Wrapper 从本地下载 gradle-xx-all.zip 文件,方法:

  1. 使用迅雷下载对应的 Gradle 工具包文件: https://services.gradle.org/distributions/gradle-4.0-rc-1-all.zip,保存在本地 D:\Download 目录。
  2. 本地启动一个 Web 服务器,让我们可以通过 http://127.0.0.1:8080/gradle-4.0-rc-1-all.zip 下载该文件。
    • 安装有 NodeJS 的机器:使用命令终端 npm install -g http-server 或者 live-server,然后使用终端命令 http-server . 快速启动一个 Web Server;
    • 安装有 Python 的机器:使用终端命令 python -m SimpleHTTPServer 8080 快速启动一个 Web Server;
  3. 修改 <ProjectDir>/gradle/wrapper/gradle-wrapper.propertiesdistributionUrl 的值为 http://127.0.0.1:8080/gradle-4.0-rc-1-all.zip (请使用自己的本地 Web服务器地址)
  4. macOS/Linux 用户打开终端,Windows 用户打开命令行窗口,并使用 cd 切换到项目目录下,接着执行 ./gradlew 命令(Windows 用户直接执行 gradlew.bat 命令)。
  5. 在命令执行成功后使用 Android Studio 打开项目,如果你的 Android Studio 已经卡在 Building Project … ,强制结束 AS 进程。

另外,Windows 用户似乎还有一种方法,修改 gradle/wrapper/gradle-wrapper.properties 文件中的键 distributionUrl 的值为 D:\download\gradle-xx.all.zip

### 解决 Android StudioGradle 相关错误的方法 当遇到 Android Studio 打开项目Gradle 出现错误的情况,可以尝试以下几种常见解决方案: #### 方法一:清理并重新同步 Gradle 缓存 如果本地缓存存在问题,可能会导致同步失败。此时可以手动删除 `.lck` 和 `.part` 文件后再进行同步操作。具体步骤如下: - 定位到项目的 `gradle` 存储目录,例如 `C:\Users\<用户名>\.gradle\caches\modules-2\files-2.1` 或者类似的路径。 - 删除该目录下所有的 `.lck` 和 `.part` 文件[^1]。 - 返回 Android Studio 并点击 **Sync Now** 进行重新同步。 #### 方法二:配置阿里云镜像加速 Gradle 下载速度 对于因网络原因造成的 Gradle 下载缓或者超时问题,可以通过修改 `gradle.properties` 文件来指定国内镜像源地址。在项目的根目录下的 `gradle.properties` 文件中添加以下内容[^3]: ```properties org.gradle.daemon=true org.gradle.parallel=true org.gradle.caching=true # 配置 Gradle 下载镜像为阿里云 gradle.downloadUrls=https://mirrors.aliyun.com/gradle/ ``` #### 方法三:更改 gradle-wrapper.properties 的分发 URL 有时默认的 Gradle 发布服务器可能无法正常访问,因此需要替换其下载链接至更稳定的资源站点。打开项目中的 `gradle/wrapper/gradle-wrapper.properties` 文件,并将其内容更新为以下形式[^4]: ```properties distributionUrl=https\://services.gradle.org/distributions/gradle-8.6-bin.zip ``` 为了进一步优化性能,也可以改为腾讯云提供的镜像服务[^5]: ```properties distributionUrl=https\://mirrors.cloud.tencent.com/gradle/distributions/gradle-8.6-bin.zip ``` #### 方法四:离线模式运行 Android Studio 在网络条件较差的情况下,可以选择启用 Gradle 的离线工作模式。通过菜单栏依次进入 **File -> Settings -> Build, Execution, Deployment -> Gradle** ,勾选选项 “Offline work”。不过需要注意的是,这种方法仅适用于已经完成必要组件下载后的场景。 以上便是针对 Android Studio 开启项目过程中可能出现的各种 Gradle 错误所提供的多种处理办法。实际应用时可根据具体情况选择合适的方式加以实施。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值