Android Studio 国内镜像使用与 SDK 下载速度优化指南

本文适用于刚装好 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.gradlerepositories

打开项目根目录的 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,不搞点镜像配置,简直寸步难行。

相关推荐
2501_915106321 天前
iOS 打包 IPA 全流程详解,签名配置、工具选择与跨平台上传实战指南
android·macos·ios·小程序·uni-app·cocoa·iphone
超低空1 天前
Android MediaSession深度解析:车载音乐播放器完整案例
android·架构·客户端
QmDeve1 天前
Android 集成与使用模糊开关按钮视图 (BlurSwitchButtonView)
android·github
00后程序员张1 天前
iOS 混淆实操指南多工具组合实现 IPA 混淆、加固与发布治理 IPA 加固
android·ios·小程序·https·uni-app·iphone·webview
xiaoshiquan12061 天前
as强制过滤指定依赖版本库,解决该依赖不同版本冲突
android
2501_929157681 天前
Switch 20.5.0系统最新PSP模拟器懒人包
android·游戏·ios·pdf
web守墓人1 天前
【编辑器】一款IDE(如VSCode等) 如何解析各类文件大纲及跳转对应行
ide·vscode·编辑器
陈皮话梅糖@1 天前
Speckit和Claude 的初体验
开发语言·ide
妮妮喔妮1 天前
pycharm远程提交Git
ide·git·pycharm
用户091 天前
Kotlin Flow的6个必知高阶技巧
android·面试·kotlin