Android Gradle 国内主流镜像仓库全局配置方案

以下是整合了国内主流镜像仓库的全局配置方案，包括阿里云、华为云、腾讯云等多个可靠镜像源。

方案一：项目级 build.gradle 完整配置 (推荐)

groovy 复制代码

buildscript {
    repositories {
        // 阿里云镜像
        maven { url 'https://maven.aliyun.com/repository/public' }
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/gradle-plugin' }
        maven { url 'https://maven.aliyun.com/repository/central' }
    
        // 华为云镜像
        maven { url 'https://repo.huaweicloud.com/repository/maven/' }
    
        // 腾讯云镜像
        maven { url 'https://mirrors.cloud.tencent.com/nexus/repository/maven-public/' }
    
        // 网易镜像
        maven { url 'https://mirrors.163.com/maven/repository/maven-public/' }
    
        // 首都在线
        maven { url 'https://maven.oscs.oschina.net/content/groups/public/' }
    
        // 保留中央仓库
        mavenCentral()
    
        // 保留Google仓库(备选)
        google()
    }
}

allprojects {
    repositories {
        // 阿里云镜像
        maven { url 'https://maven.aliyun.com/repository/public' }
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/central' }
    
        // 华为云镜像
        maven { url 'https://repo.huaweicloud.com/repository/maven/' }
    
        // 腾讯云镜像
        maven { url 'https://mirrors.cloud.tencent.com/nexus/repository/maven-public/' }
    
        // 网易镜像
        maven { url 'https://mirrors.163.com/maven/repository/maven-public/' }
    
        // 首都在线
        maven { url 'https://maven.oscs.oschina.net/content/groups/public/' }
    
        // 保留中央仓库
        mavenCentral()
    
        // 保留Google仓库(备选)
        google()
    }
}

方案二：全局 init.gradle 配置 (用户级)

在 ~/.gradle/init.gradle 文件中添加：

groovy 复制代码

allprojects {
    repositories {
        // 移除默认仓库
        all { ArtifactRepository repo ->
            if (repo instanceof MavenArtifactRepository) {
                def url = repo.url.toString()
                if (url.contains('repo1.maven.org/maven2') || 
                    url.contains('jcenter.bintray.com') || 
                    url.contains('maven.google.com') || 
                    url.contains('plugins.gradle.org/m2')) {
                    remove repo
                }
            }
        }
    
        // 添加国内主流镜像仓库
        // 阿里云镜像
        maven { 
            url 'https://maven.aliyun.com/repository/public'
            allowInsecureProtocol = true
        }
        maven { 
            url 'https://maven.aliyun.com/repository/google'
            allowInsecureProtocol = true
        }
        maven { 
            url 'https://maven.aliyun.com/repository/gradle-plugin'
            allowInsecureProtocol = true
        }
    
        // 华为云镜像
        maven { 
            url 'https://repo.huaweicloud.com/repository/maven/'
            allowInsecureProtocol = true
        }
    
        // 腾讯云镜像
        maven { 
            url 'https://mirrors.cloud.tencent.com/nexus/repository/maven-public/'
            allowInsecureProtocol = true
        }
    
        // 网易镜像
        maven { 
            url 'https://mirrors.163.com/maven/repository/maven-public/'
            allowInsecureProtocol = true
        }
    
        // 首都在线
        maven { 
            url 'https://maven.oscs.oschina.net/content/groups/public/'
            allowInsecureProtocol = true
        }
    
        // 保留中央仓库
        mavenCentral()
    }
}

方案三：gradle-wrapper.properties 镜像配置

修改 gradle/wrapper/gradle-wrapper.properties 使用国内镜像下载Gradle：

ruby 复制代码

# 阿里云镜像
distributionUrl=https\://mirrors.aliyun.com/gradle/gradle-8.0-bin.zip

# 或腾讯云镜像
# distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-8.0-bin.zip

# 或华为云镜像
# distributionUrl=https\://repo.huaweicloud.com/gradle/gradle-8.0-bin.zip

方案四：全局 gradle.properties 配置

在 ~/.gradle/gradle.properties 中添加：

ini 复制代码

# 使用阿里云镜像代理
systemProp.http.proxyHost=mirrors.aliyun.com
systemProp.http.proxyPort=80
systemProp.https.proxyHost=mirrors.aliyun.com
systemProp.https.proxyPort=80

# 或者使用腾讯云代理
# systemProp.http.proxyHost=mirrors.cloud.tencent.com
# systemProp.http.proxyPort=80
# systemProp.https.proxyHost=mirrors.cloud.tencent.com
# systemProp.https.proxyPort=80

国内主流镜像仓库列表

镜像提供商	仓库地址
阿里云	`https://maven.aliyun.com/repository/public`
阿里云(Google)	`https://maven.aliyun.com/repository/google`
阿里云(Gradle插件)	`https://maven.aliyun.com/repository/gradle-plugin`
华为云	`https://repo.huaweicloud.com/repository/maven/`
腾讯云	`https://mirrors.cloud.tencent.com/nexus/repository/maven-public/`
网易	`https://mirrors.163.com/maven/repository/maven-public/`
首都在线	`https://maven.oscs.oschina.net/content/groups/public/`
中国科学技术大学	`https://mirrors.ustc.edu.cn/nexus/content/groups/public/`

最佳实践建议

推荐组合：阿里云 + 华为云 + 腾讯云镜像组合使用
优先级：将最快的镜像源放在前面
保留原始仓库 ：保留 mavenCentral() 和 google() 作为备选
版本更新：定期检查镜像仓库是否同步了最新依赖
网络测试：不同地区对不同镜像的访问速度可能有差异，建议测试后选择最优组合

以上配置已经覆盖了国内主流的镜像仓库，可以有效解决Android项目构建时的依赖下载问题。