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.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,不搞点镜像配置,简直寸步难行。

相关推荐
千里马学框架3 天前
一起学 Android 14:ShellTransition 屏幕旋转过程深度剖析
android·智能手机·性能优化·framework·性能·屏幕旋转·rotation
美狐美颜SDK开放平台3 天前
开发直播APP时如何接入视频美颜SDK?开发流程与注意事项
android·人工智能·计算机视觉·音视频·直播美颜sdk
AFinalStone3 天前
Android7 SystemUI源码解析(七)Keyguard锁屏模块深度解析
android·systemui
致远ccc3 天前
Google Play 上架前如何测试 App?多国家 Android 环境测试
android·app测试·googleplay·多国家应用测试
ttyyttemo3 天前
Kotlin 协程中的 Job 结构化并发与取消
android
sun0077003 天前
tbox 4g/5g切换,导致wan ip 改变,导致车机旧网络不可用。需要重启车机才行
android
其实防守也摸鱼3 天前
内网穿透与反向代理:原理、工具与实战指南
android·大数据·运维·安全·网络安全·自动化·渗透
AFinalStone3 天前
Android7 SystemUI 源码解析(四)NavigationBar 导航栏与 SystemBars
android·systemui
JMchen3 天前
属性动画原理与高级动画实现
android·kotlin·canvas
AFinalStone3 天前
Android7 SystemUI 源码解析(二)启动流程深度解析
android·systemui