首页 > 软件编程 > Android > Android Gradle国内镜像仓库配置

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

2025-07-25 08:28:50 作者：Huckings

这篇文章主要介绍了国内主流镜像仓库的全局配置方案,包括阿里云、华为云、腾讯云等多个可靠镜像源,已经覆盖了国内主流的镜像仓库,可以有效解决Android项目构建时的依赖下载问题,本文给大家通过代码示例介绍的非常详细,需要的朋友可以参考下

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

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

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

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 文件中添加：

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：

# 阿里云镜像
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 中添加：

# 使用阿里云镜像代理
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项目构建时的依赖下载问题。

到此这篇关于Android Gradle国内主流镜像仓库全局配置方案的文章就介绍到这了,更多相关Android Gradle国内镜像仓库配置内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！