【Android】Android Studio 配置国内镜像源

一、修改 hosts，解决 SDK 下载失败的问题

Windows

1. 用文本编辑器打开 host 文件（推荐使用 Visual Studio Code）

   C:\Windows\System32\drivers\etc\hosts
   

2. 添加映射

   220.181.174.161        dl.google.com
   

   注：其中 220.181.174.161 是通过 http://ping.chinaz.com/ 该检测网站对进行域名 dl.google.com 进行 ping 检测得到了，目前这个还是可以用的，如果后来不行了可以去该网站 ping dl.google.com 再另外找一个。

macOS

1. 用文本编辑器打开 host 文件（推荐使用 Visual Studio Code）

   /etc/hosts
   

2. 添加映射

   220.181.174.161        dl.google.com
   

Linux

1. 用文本编辑器打开 host 文件（推荐使用 Visual Studio Code）

   /etc/hosts
   

2. 添加映射

   220.181.174.161        dl.google.com
   

3. 重启网络

   service network-manager restart
   

二、修改 gradle 地址，解决 gradle 下载失败的问题

依次打开 gradle $\to$ wrapper $\to$ gradle-wrapper.properties

#Fri Apr 11 10:25:03 CST 2025
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-8.11.1-bin.zip
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists

三、使用阿里云 Maven 中央仓库，解决插件和依赖项下载失败的问题

settings.gradle 版本

pluginManagement {
    repositories {
        maven { url 'https://www.jitpack.io' }
        maven { url 'https://maven.aliyun.com/repository/releases' }
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/central' }
        maven { url 'https://maven.aliyun.com/repository/gradle-plugin' }
        maven { url 'https://maven.aliyun.com/repository/public/' }
        gradlePluginPortal()
        google()
        mavenCentral()
    }
}

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        maven { url 'https://www.jitpack.io' }
        maven { url 'https://maven.aliyun.com/repository/releases' }
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/central' }
        maven { url 'https://maven.aliyun.com/repository/gradle-plugin' }
        maven { url 'https://maven.aliyun.com/repository/public' }
        google()
        mavenCentral()
    }
}

rootProject.name = "My Application"
include ':app'

settings.gradle.kts 版本

pluginManagement {
    repositories {
        maven { url = uri("https://www.jitpack.io") }
        maven { url = uri("https://maven.aliyun.com/repository/releases") }
        maven { url = uri("https://maven.aliyun.com/repository/google") }
        maven { url = uri("https://maven.aliyun.com/repository/central") }
        maven { url = uri("https://maven.aliyun.com/repository/gradle-plugin") }
        maven { url = uri("https://maven.aliyun.com/repository/public") }
        google {
            content {
                includeGroupByRegex("com\\.android.*")
                includeGroupByRegex("com\\.google.*")
                includeGroupByRegex("androidx.*")
            }
        }
        mavenCentral()
        gradlePluginPortal()
    }
}

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        maven { url = uri("https://www.jitpack.io") }
        maven { url = uri("https://maven.aliyun.com/repository/releases") }
        maven { url = uri("https://maven.aliyun.com/repository/google") }
        maven { url = uri("https://maven.aliyun.com/repository/central") }
        maven { url = uri("https://maven.aliyun.com/repository/gradle-plugin") }
        maven { url = uri("https://maven.aliyun.com/repository/public") }
        google()
        mavenCentral()
    }
}

rootProject.name = "My Application"
include(":app")