android studio gradle.wrapper 换源
时间: 2025-06-03 09:18:59 浏览: 11
### 更换 Android Studio 中 Gradle Wrapper 的国内镜像源
为了提高下载速度并解决网络不稳定的问题,可以将 Gradle Wrapper 配置为使用国内的阿里云或腾讯镜像源。以下是具体的配置方法:
#### 1. 修改 `gradle-wrapper.properties` 文件
在项目的根目录下找到 `gradle/wrapper/gradle-wrapper.properties` 文件。如果该文件不存在,则可以通过创建新项目自动生成。
编辑此文件并将其中的 `distributionUrl` 替换为国内镜像地址。例如,使用阿里云镜像时可设置如下内容[^2]:
```properties
distributionUrl=https\://mirrors.aliyun.com/gradle/distributions/gradle-7.0-bin.zip
```
如果是腾讯镜像,则替换为以下内容[^1]:
```properties
distributionUrl=https\://mirrors.cloud.tencent.com/gradle/distributions/gradle-7.0-bin.zip
```
注意:上述 URL 中的版本号(如 `gradle-7.0-bin.zip`)应根据实际需求调整至最新稳定版或其他指定版本。
---
#### 2. 配置 Maven 仓库镜像
除了更改 Gradle 下载源外,还可以通过修改 `build.gradle` 文件来优化依赖项的下载速度。具体操作是在项目的顶级 `build.gradle` 或模块级 `build.gradle` 文件中加入以下内容[^3]:
```groovy
repositories {
maven { url 'https://maven.aliyun.com/repository/public' }
}
```
这样即可让所有的 Maven 依赖都优先从阿里云镜像站点获取资源。同样支持其他镜像源,比如腾讯云等。
---
#### 3. 清理缓存与同步项目
完成以上两步之后,在 Android Studio 菜单栏依次点击 **File -> Invalidate Caches / Restart...** 来清理旧数据;随后重新启动 IDE 并等待其自动同步新的构建脚本和库文件。
---
### 总结
通过更新 `gradle-wrapper.properties` 和 `build.gradle` 文件中的相应字段,能够显著改善因国际网络连接不佳而导致的长时间等待现象。最终实现高效稳定的开发环境搭建过程。
阅读全文
相关推荐


















