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 {
        // 移除默認倉庫
        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)主流鏡像倉庫列表

最佳實踐建議

1. 推薦組合：阿里云 + 華為云 + 騰訊云鏡像組合使用
2. 優(yōu)先級：將最快的鏡像源放在前面
3. 保留原始倉庫：保留 mavenCentral()? 和 google()? 作為備選
4. 版本更新：定期檢查鏡像倉庫是否同步了最新依賴
5. 網(wǎng)絡(luò)測試：不同地區(qū)對不同鏡像的訪問速度可能有差異，建議測試后選擇最優(yōu)組合

以上配置已經(jīng)覆蓋了國內(nèi)主流的鏡像倉庫，可以有效解決Android項目構(gòu)建時的依賴下載問題。