Add Gradle Mirror

配置 Gradle 镜像源可以显著提升国内开发环境下的依赖下载速度。以下是几种主流配置方式，适用于不同场景（全局、项目级、Gradle 5.0+ 推荐方式），并附带常用国内镜像地址。

✅ 方法一：全局配置（推荐用于个人开发）

适用于 所有 Gradle 项目，只需配置一次，永久生效。

步骤：

1. 找到或创建 Gradle 用户主目录下的 init.gradle 文件：
   • Windows: C:\Users\<用户名>\.gradle\init.gradle
   • macOS/Linux: ~/.gradle/init.gradle
2. 添加以下内容：

allprojects {
    repositories {
        maven { url = uri("https://maven.aliyun.com/repository/public") }
        maven { url = uri("https://repo.huaweicloud.com/repository/maven/") }
        maven { url = uri("https://mirrors.cloud.tencent.com/nexus/repository/maven-public/") }
        
        google()
        mavenCentral()
        gradlePluginPortal()
    }
}

这将替换默认的 Maven 中央仓库等源，优先使用国内镜像。

如果项目中有配置dependencyResolutionManagement，则添加全局init.gradle配置要导致冲突：Build was configured to prefer settings repositories over project repositories but repository 'maven' was added by settings file 'settings.gradle.kts'，需要删了init.gradle

✅ 方法二：项目级配置（适合团队协作）

修改项目根目录下的 build.gradle 文件：

allprojects {
    repositories {
        maven { url = uri("https://maven.aliyun.com/repository/public") }
        maven { url = uri("https://repo.huaweicloud.com/repository/maven/") }
        maven { url = uri("https://mirrors.cloud.tencent.com/nexus/repository/maven-public/") }
        
        google()
        mavenCentral()
    }
}

项目级配置确保团队成员克隆项目后自动生效，无需额外设置。

✅ 方法三：使用 settings.gradle（Gradle 5.0+ 推荐）

在 settings.gradle 中添加：

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        maven { url = uri("https://maven.aliyun.com/repository/public") }
        maven { url = uri("https://repo.huaweicloud.com/repository/maven/") }
        maven { url = uri("https://mirrors.cloud.tencent.com/nexus/repository/maven-public/") }
        
        google()
        mavenCentral()
        gradlePluginPortal()
    }
}

这是 Gradle 官方推荐方式，集中管理仓库配置，结构清晰。

⚙️ 方法四：配置 Gradle Wrapper 镜像（解决 gradle-src.zip 下载慢）

修改 gradle/wrapper/gradle-wrapper.properties 中的 distributionUrl：

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

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

这将加速 Gradle 本身（如 gradle-bin.zip 或 gradle-src.zip）的下载。

📌 常用国内镜像地址

✅ 总结建议

• 个人开发：使用全局 init.gradle 配置（方法一）。
• 团队项目：使用 settings.gradle（方法三）+ gradle-wrapper.properties 配置镜像。
• 构建慢或失败：结合清除缓存命令 ./gradlew --stop 或删除 ~/.gradle/caches/ 后重试。

如你使用的是 Android Studio，它也支持在 Settings > Build Tools > Gradle > Gradle JDK 和 gradle.properties 中设置代理或镜像。

需要我帮你检查具体项目的配置是否正确？可以贴出你的 build.gradle 或 settings.gradle 内容。