Android Studio 常见问题

问题一.Android Studio 编译gradle项目报错：ERROR: Could not install Gradle distribution from ‘https://services.gradle.org/distributions/gradle

1.1.问题背景

在新建或导入项目时，经常会出现 Gradle 报错，这通常是因为 Gradle 文件存储在国外网站，下载速度慢，容易导致下载失败。

1.2. 解决步骤

1. 确认 Gradle 版本：打开项目目录下的gradle-wrapper.properties文件，找到distributionUrl属性，确保其指向的 Gradle 版本与项目需求一致。
2. 修改镜像地址：将distributionUrl修改为国内镜像地址，以下是常用的国内镜像：
   • 腾讯云镜像：https://mirrors.cloud.tencent.com/gradle/
   • 阿里云镜像：https://mirrors.aliyun.com/macports/distfiles/gradle/
     修改示例：distributionUrl=https://mirrors.tencent.com/gradle/gradle-8.13-bin.zip
3. 保存并同步项目：保存gradle-wrapper.properties文件后，返回开发工具（如 Android Studio），点击Try Again或Sync Project with Gradle Files重新同步项目。
4. 重启开发工具：如果问题仍然存在，关闭项目并重启开发工具，然后再次尝试同步项目。

1.3.镜像地址参考

• 腾讯云镜像 Gradle 下载地址：

https://mirrors.cloud.tencent.com/gradle/

• 阿里云镜像 Gradle 下载地址：

https://mirrors.aliyun.com/macports/distfiles/gradle/

通过以上步骤，通常可以解决由于下载速度慢导致的 Gradle 报错问题。

问题 二.Android Studio 编译gradle项目报错：Cause: zip END header not found

2.1 解决方式：

点击File–>Setting，打开.gradle 包下的dists，删除里面的文件夹，重新编译gradle项目

2.2 直接删除 .gradle\wrapper\dists\gradle-8.13-bin 文件夹下的所有问题

2.3 点击 Try Again 或 Sync Project with Gradle Files 重新同步项目

三.Android Studio 设置阿里云源-新旧版本配置

3.1 settings.gradle.kts新版本文件修改

maven{url=uri("https://maven.aliyun.com/repository/public/")}maven{url=uri("https://maven.aliyun.com/repository/google/")}maven{url=uri("https://maven.aliyun.com/repository/jcenter/")}maven{url=uri("https://maven.aliyun.com/repository/central/")}

3.2 settings.gradle旧版本文件修改

maven{url'https://maven.aliyun.com/repository/public/'}maven{url'https://maven.aliyun.com/repository/google/'}maven{url'https://maven.aliyun.com/repository/jcenter/'}maven{url'https://maven.aliyun.com/repository/central/'}

3.2 settings.gradle文件修改后的样图