Android Studio全流程换源指南
2025年8月20日 00:56
Android的东家Google在中国大陆受到大规模封锁,Gradle的官方服务器,受限于我国匮乏的国际出口带宽,下载速度也不理想。这给作为开发者的我们带来了诸多不便,这一不便又被Android Studio与Gradle包管理的复杂放大了,不能像linux包管理器或者pip那样一行命令搞定。想要在Android Studio开发全过程中尽可能多用上国内镜像站并不容易。本文大致记录一下。
因为我这里腾讯云与阿里云的镜像最快,所以我配置成了这两家,可酌情修改。
Android Studio SDK Update
这部分内容应该首先配置,因为第一次启动Android Studio时会有向导指引你安装SDK,此时如果不加以配置,会从默认的dl.google.com下载,虽然没有被封锁,但是速度终归有点慢。
配置的方式是按cancel按键退出向导,点击左下角齿轮打开设置,然后导航到这个位置:

(我已经添加过了)
点击加号,名称随意,添加以下两个条目:
1 | https://mirrors.aliyun.com/android.googlesource.com |
与
1 | https://mirrors.cloud.tencent.com/AndroidSDK/ |
这会对速度有一定提升。
全局Gradle配置
在linux与Mac上位于~/.gradle/gradle.properties
添加以下内容:
1 | maven.repo.remote=https\://maven.aliyun.com/repository/google,https\://maven.aliyun.com/repository/jcenter,https\://maven.aliyun.com/repository/public |
Gradle程序下载
在Android Studio自动生成的项目结构下,配置文件应该位于 gradle/wrapper/gradle-wrapper.properties
在我这里,生成的版本如下:(版本号不同很正常)
1 | distributionBase=GRADLE_USER_HOME |
网上的教程大多告诉你把链接换成腾讯镜像的,可是实际操作中会发现还是要连接services.gradle.org导致sync过程卡死,因为这里只提供了bin二进制包,我们还同时需要src源码(虽然我还不清楚为什么)
正确的修改应该如下:(版本号需要依据实际情况修改)
1 | distributionBase=GRADLE_USER_HOME |
all包是我们需要的,它相当于bin加上src
Gradle项目配置
位于项目根目录下的settings.gradle.kts
一般而言,只需要修改以下内容