快捷導(dǎo)航

Android Gradle國內(nèi)主流鏡像倉庫全局配置方案

更新時間：2025年07月25日 08:28:49 作者：Huckings

這篇文章主要介紹了國內(nèi)主流鏡像倉庫的全局配置方案,包括阿里云、華為云、騰訊云等多個可靠鏡像源,已經(jīng)覆蓋了國內(nèi)主流的鏡像倉庫,可以有效解決Android項目構(gòu)建時的依賴下載問題,本文給大家通過代碼示例介紹的非常詳細(xì),需要的朋友可以參考下

Android Gradle 國內(nèi)主流鏡像倉庫全局配置方案

以下是整合了國內(nèi)主流鏡像倉庫的全局配置方案，包括阿里云、華為云、騰訊云等多個可靠鏡像源。

方案一：項目級 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/' }
    
        // 網(wǎng)易鏡像
        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/' }
    
        // 網(wǎng)易鏡像
        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 {
        // 移除默認(rèn)倉庫
        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
                }
            }
        }
    
        // 添加國內(nèi)主流鏡像倉庫
        // 阿里云鏡像
        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
        }
    
        // 網(wǎng)易鏡像
        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? 使用國內(nèi)鏡像下載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

國內(nèi)主流鏡像倉庫列表

鏡像提供商	倉庫地址
阿里云	?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/?
網(wǎng)易	?https://mirrors.163.com/maven/repository/maven-public/?
首都在線	?https://maven.oscs.oschina.net/content/groups/public/?
中國科學(xué)技術(shù)大學(xué)	?https://mirrors.ustc.edu.cn/nexus/content/groups/public/?