Android studio 换源

### 更换 Android Studio 中的软件源或配置国内镜像源 在 Android Studio 中更换软件源或配置国内镜像源，可以有效解决因网络环境导致的 Gradle 下载缓慢或失败问题。以下是具体的配置方法和相关注意事项。 #### 一、更改 Gradle 镜像源 Gradle 是 Android Studio 构建项目的核心工具，因此首先需要确保其下载地址被替换为国内镜像站点。可以通过修改 `gradle-wrapper.properties` 文件实现此目的。 在项目的 `gradle/wrapper/gradle-wrapper.properties` 文件中，将 `distributionUrl` 替换为国内镜像地址。例如： ```properties distributionBase=GRADLE_USER_HOME distributionPath=wrapper/dists distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-8.0-bin.zip zipStoreBase=GRADLE_USER_HOME zipStorePath=wrapper/dists ``` 上述配置中使用了腾讯云的 Gradle 镜像[^2]。如果需要使用阿里云镜像，则可以将 `distributionUrl` 替换为以下内容： ```properties distributionUrl=https\://mirrors.aliyun.com/gradle/gradle-8.0-bin.zip ``` #### 二、配置 Maven 仓库镜像 除了 Gradle 的下载地址外，还需要确保依赖库的下载地址也被替换为国内镜像源。这通常通过修改 `settings.gradle` 或 `build.gradle` 文件实现。 ##### 1. 使用 Kotlin DSL (build.gradle.kts) 对于使用 Kotlin DSL 的项目，可以在 `settings.gradle.kts` 文件中添加以下内容： ```kotlin dependencyResolutionManagement { repositories { maven { setUrl("https://maven.aliyun.com/repository/central") } maven { setUrl("https://maven.aliyun.com/repository/google") } maven { setUrl("https://maven.aliyun.com/repository/jcenter") } maven { setUrl("https://maven.aliyun.com/repository/gradle-plugin") } maven { setUrl("https://jitpack.io") } google() mavenCentral() } } ``` 上述配置替换了默认的 Maven 中央仓库和 Google 仓库为阿里云镜像[^4]。 ##### 2. 使用 Groovy DSL (build.gradle) 对于使用传统 Groovy DSL 的项目，可以在 `build.gradle` 文件中添加以下内容： ```groovy allprojects { repositories { def ALIYUN_REPOSITORY_URL = 'https://maven.aliyun.com/nexus/content/groups/public' def ALIYUN_JCENTER_URL = 'https://maven.aliyun.com/nexus/content/repositories/jcenter' all { ArtifactRepository repo -> if (repo instanceof MavenArtifactRepository) { def url = repo.url.toString() if (url.startsWith('https://repo1.maven.org/maven2')) { project.logger.lifecycle "Repository ${repo.url} replaced by $ALIYUN_REPOSITORY_URL." remove repo } if (url.startsWith('https://jcenter.bintray.com/')) { project.logger.lifecycle "Repository ${repo.url} replaced by $ALIYUN_JCENTER_URL." remove repo } } } maven { url ALIYUN_REPOSITORY_URL } maven { url ALIYUN_JCENTER_URL } } } ``` 该配置会自动替换默认的 Maven 和 JCenter 仓库为阿里云镜像[^5]。 #### 三、同步 Gradle 完成上述配置后，点击 Android Studio 工具栏中的 **Sync Now** 按钮以同步项目。如果一切配置正确，Gradle 将从指定的国内镜像源下载所需的文件。 --- ### 注意事项 1. 确保 `distributionUrl` 中的 Gradle 版本与项目需求一致。 2. 如果项目中有多个模块，需检查每个模块的 `build.gradle` 文件是否包含正确的仓库配置。 3. 在某些情况下，可能需要清理缓存并重新启动 Android Studio。可以通过菜单栏中的 **File > Invalidate Caches / Restart** 实现。 ---