使用 Android Studio 创建项目后,会使用默认的地址去下载 Gradle 和相关依赖,如果网络环境较差,下载速度会十分缓慢,此时需要配置镜像源。

依赖下载的镜像源配置:打开项目根目录的 settings.gradle.kts , 设置 pluginManagement 和 dependencyResolutionManagement 中的 repositories 选项, 添加 maven 镜像配置:

pluginManagement {
    repositories {
        maven { url = uri("https://maven.aliyun.com/repository/gradle-plugin") }
        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://maven.aliyun.com/repository/google") }
        maven { url = uri("https://maven.aliyun.com/repository/public") }
        google()
        mavenCentral()
    }
}

Gradle 镜像配置:打开 gradle/wrapper/gradle-wrapper.properties 文件,替换为腾讯云镜像地址:

distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-8.8-all.zip

记得要使用 -all 后缀的文件,这是包含源码的。如果只是 -bin 文件,Android Studio 有可能会继续从 gradle 官网下载源码,速度巨慢!