为 Android 项目添加国内镜像以加速依赖下载，主要需要修改 Gradle 配置文件

要为Android项目添加国内镜像以加速依赖下载，主要需要修改Gradle配置文件，以下是具体步骤：

1. 修改顶级 build.gradle.kts

添加阿里云镜像仓库，替换默认的Google和Maven仓库

// Top-level build file (D:\hobby\project\X1\build.gradle.kts)
@file:Suppress("UnstableApiUsage") // 抑制 Gradle 不稳定 API 警告（如 allprojects）

plugins {
    id("com.android.application") version "8.2.0" apply false
    id("org.jetbrains.kotlin.android") version "1.9.0" apply false
}

// 1. 配置构建脚本的依赖仓库（AGP 插件从这里下载）
buildscript {
    repositories {
        // 国内镜像优先：阿里云 Google 仓库（必须有，AGP 仅存于此）
        maven { url = uri("https://maven.aliyun.com/repository/google") }
        // 阿里云 Gradle 插件仓库（补充）
        maven { url = uri("https://maven.aliyun.com/repository/gradle-plugin") }
        // 阿里云中央仓库（兜底）
        maven { url = uri("https://maven.aliyun.com/repository/central") }
        // 原始仓库兜底（若镜像失效）
        google()
        mavenCentral()
    }
    // （可选）显式声明 AGP 插件依赖（避免版本匹配问题）
    dependencies {
        classpath("com.android.tools.build:gradle:8.2.0")
        classpath("org.jetbrains.kotlin:kotlin-gradle-plugin:1.9.0")
    }
}

// 2. 配置项目依赖仓库（普通依赖，如第三方库）
allprojects {
    repositories {
        maven { url = uri("https://maven.aliyun.com/repository/google") }
        maven { url = uri("https://maven.aliyun.com/repository/jcenter") }
        maven { url = uri("https://maven.aliyun.com/repository/central") }
        google()
        mavenCentral()
    }
}

2. 修改 settings.gradle.kts

如果存在该文件，添加仓库镜像配置（通常用于Gradle 7.0+版本）：

// D:\hobby\project\X1\settings.gradle.kts
pluginManagement {
    // 专门用于插件的仓库配置（AGP 插件从这里加载）
    repositories {
        maven { url = uri("https://maven.aliyun.com/repository/google") }
        maven { url = uri("https://maven.aliyun.com/repository/gradle-plugin") }
        maven { url = uri("https://maven.aliyun.com/repository/central") }
        gradlePluginPortal() // Gradle 官方插件仓库（兜底）
        google()
    }
}

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        // 项目依赖仓库（与 build.gradle.kts 的 allprojects 一致）
        maven { url = uri("https://maven.aliyun.com/repository/google") }
        maven { url = uri("https://maven.aliyun.com/repository/jcenter") }
        maven { url = uri("https://maven.aliyun.com/repository/central") }
        google()
        mavenCentral()
    }
}

rootProject.name = "X1"
include(":app")

3. 修改Gradle wrapper配置

编辑 gradle/wrapper/gradle-wrapper.properties，使用阿里云的Gradle分发镜像：

#Sun Sep 21 13:11:13 CST 2025
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
# 替换为腾讯云镜像（较稳定）
distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-8.2-bin.zip
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists

这些配置通过替换Google、Maven中央仓库等为阿里云镜像，能显著提升国内网络环境下的依赖下载速度。配置后建议执行 gradlew clean build 重新构建项目，使镜像配置生效。