本文适用于刚装好 Android Studio、SDK 下载缓慢、更新困难,以及 Gradle 构建缓慢的开发者。我们会讲:
-
如何替换国内镜像源(包括 SDK 和 Gradle)
-
如何解决 emulator 镜像下载失败的问题
-
一些终极提速技巧(比如代理配置)

一、SDK 国内镜像配置
1. 更改 sdk-manager
下载源
我们需要改的是 Android SDK 的 dl.google.com
下载链接。
打开你的 Android Studio
安装目录下的:
<你的安装路径>/bin/idea.properties
添加如下配置(如果没有就新建):
disable.android.first.run=true
这个操作可以防止首次启动就自动检查 SDK 更新。然后手动配置下载源。
接着打开 tools/bin/sdkmanager
,你可以指定代理或换国内镜像源来下载。我们推荐使用清华大学的镜像站。
2. 配置清华镜像(推荐)
编辑 SDK Manager 的配置:
cd ~/Android/Sdk/tools/bin
./sdkmanager --no_https --proxy=http --proxy_host=mirrors.tuna.tsinghua.edu.cn --proxy_port=80 "platform-tools"
你也可以添加一个配置文件 ~/.android/repositories.cfg
:
### repositories.cfg
### 使用国内镜像,比如阿里、清华、中科大
不过更推荐直接配置 build.gradle
。
二、Gradle 国内加速配置
这个不改基本就别想顺利 Sync 项目。
修改 gradle-wrapper.properties
打开你的项目目录下的 gradle/wrapper/gradle-wrapper.properties
文件:
distributionUrl=https\://services.gradle.org/distributions/gradle-7.4-all.zip
替换为阿里镜像:
distributionUrl=https\://mirrors.aliyun.com/gradle/gradle-7.4-all.zip
修改 build.gradle
的 repositories
打开项目根目录的 build.gradle
文件,找到:
allprojects {
repositories {
google()
mavenCentral()
jcenter() // 如果有
}
}
改成国内源:
allprojects {
repositories {
maven { url 'https://maven.aliyun.com/repository/google' }
maven { url 'https://maven.aliyun.com/repository/central' }
maven { url 'https://maven.aliyun.com/repository/jcenter' }
}
}
别忘了把 settings.gradle
里也同步下这块。
三、Emulator 镜像下载失败?这有解!
Emulator 镜像的下载地址一般是:
https://dl.google.com/android/repository/sys-img/...
很多时候根本连不上。国内目前较好的解决方案是:
方法一:手动下载 system image
可以去清华镜像站:
👉 https://mirrors.tuna.tsinghua.edu.cn/help/android/
里面有 system-images 目录,直接找对应的版本下载,然后丢到:
<SDK路径>/system-images/
文件结构一定要对,比如 android-30/google_apis/x86/
方法二:使用代理
如果你能挂代理,直接在 Android Studio 中设置:
File -> Settings -> Appearance & Behavior -> System Settings -> HTTP Proxy
选择 Manual proxy configuration
,填上你自己本地代理的端口。
四、终极技巧:使用国产 IDE 版本
如果你实在懒得折腾,还可以试试国产的 Android Studio 魔改版,比如:
-
GoLand-Android(JetBrains 系列魔改)
-
Himalaya Studio(社区版)
这些版本自带了国内镜像配置,开箱即用,不用你手动改配置。
五、总结一下
项目 | 原始地址 | 替代方案(镜像) |
---|---|---|
SDK下载 | dl.google.com |
清华、中科大、阿里、华为镜像 |
Gradle 下载 | services.gradle.org |
阿里镜像(mirrors.aliyun.com) |
Maven依赖 | mavenCentral , jcenter , google() |
替换为阿里/清华 maven 镜像 |
Emulator 镜像下载 | dl.google.com/android/repository |
手动下载 + 挂代理 |
写在最后
如果你已经看腻了"科学上网解决一切"的方案,强烈建议把这些国内镜像配置熟练掌握,毕竟:
国内写 Android,不搞点镜像配置,简直寸步难行。