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

相关推荐
阿巴斯甜14 小时前
Android 报错:Zip file '/Users/lyy/develop/repoAndroidLapp/l-app-android-ble/app/bu
android
Kapaseker15 小时前
实战 Compose 中的 IntrinsicSize
android·kotlin
xq952716 小时前
Andorid Google 登录接入文档
android
黄林晴17 小时前
告别 Modifier 地狱,Compose 样式系统要变天了
android·android jetpack
冬奇Lab1 天前
Android触摸事件分发、手势识别与输入优化实战
android·源码阅读
城东米粉儿1 天前
Android MediaPlayer 笔记
android
Jony_1 天前
Android 启动优化方案
android
阿巴斯甜1 天前
Android studio 报错:Cause: error=86, Bad CPU type in executable
android
张小潇1 天前
AOSP15 Input专题InputReader源码分析
android
_小马快跑_2 天前
Kotlin | 协程调度器选择:何时用CoroutineScope配置,何时用launch指定?
android