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

相关推荐
界面开发小八哥1 小时前
「Java EE开发指南」用MyEclipse开发EJB 3无状态会话Bean(二)
java·ide·java-ee·eclipse·myeclipse
电子艾号哲2 小时前
Vscode开发STM32标准库
ide·vscode·stm32
那就摆吧2 小时前
数据结构-栈
android·java·c语言·数据结构
奔跑吧 android2 小时前
【android bluetooth 框架分析 02】【Module详解 4】【Btaa 模块介绍】
android·bluetooth·bt·aosp13·btaa
tangweiguo030519872 小时前
Android Compose Activity 页面跳转动画详解
android·compose
Yang-Never3 小时前
ADB -> pull指令拉取手机文件到电脑上
android·adb·android studio
Yang-Never3 小时前
ADB -> pull指令推送电脑文件到手机上
android·adb·android studio
李新_3 小时前
我们封装了哪些好用的Flutter Mixin
android·flutter
帅次3 小时前
Flutter Expanded 与 Flexible 详解
android·flutter·ios·小程序·webview