Android Studio 镜像加速

6 阅读2分钟

配置 Gradle 镜像加速(依赖下载层)​

即使配置了代理,国内访问 services.gradle.org 可能仍较慢。建议将 Gradle 仓库替换为国内镜像(如阿里云、腾讯云):

​1. 修改 gradle-wrapper.properties

在项目根目录的 gradle/wrapper/gradle-wrapper.properties 文件中,修改 distributionUrl 为国内镜像地址:

# 原地址(注释或删除)
# distributionUrl=https://services.gradle.org/distributions/gradle-8.13-bin.zip

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

# 阿里云镜像
# distributionUrl=https://mirrors.aliyun.com/gradle/gradle-8.13-bin.zip

​2. 配置项目级仓库镜像​

在 settings.gradle 或 build.gradle 中替换仓库地址:

// settings.gradle (新版本 Android Studio)
pluginManagement {
    repositories {
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/central' }
        gradlePluginPortal()
    }
}

// build.gradle (旧版本)
allprojects {
    repositories {
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/central' }
        google()
        mavenCentral()
    }
}

​验证配置​

  1. ​同步项目​​:点击 Android Studio 右上角的 Sync Now,观察依赖下载速度是否提升。

  2. ​手动触发下载​​:

    • 执行 File > Invalidate Caches / Restart 清理缓存。
    • 在终端运行 ./gradlew build --refresh-dependencies 强制刷新依赖。

​常见问题解决​

​1. 代理配置无效​

  • ​检查代理地址和端口​​:确保与网络环境一致(如公司代理可能需要用户名/密码)。
  • ​关闭 VPN 或防火墙​​:部分安全软件可能拦截代理流量。

​2. Gradle 下载失败​

  • ​手动下载 Gradle​​:

    1. 从镜像地址下载 gradle-8.13-bin.zip
    2. 放置到路径:~/.gradle/wrapper/dists/gradle-8.13-bin/<随机目录>/
    3. 重新同步项目,Gradle 会自动解压使用 。
  • ​检查网络策略​​:某些代理可能限制访问 maven.aliyun.com,需联系网络管理员调整规则。


​五、推荐镜像地址​

​服务商​​Gradle 镜像地址​​Maven 仓库地址​
腾讯云https://mirrors.cloud.tencent.com/gradlehttps://mirrors.cloud.tencent.com/maven
阿里云https://mirrors.aliyun.com/gradlehttps://mirrors.aliyun.com/maven
华为云https://repo.huaweicloud.com/repository/gradlehttps://repo.huaweicloud.com/repository/maven

​总结​

通过 ​​代理设置​​ 解决网络访问限制,再通过 ​​Gradle 镜像加速​​ 提升依赖下载速度,可有效解决国内开发环境下的网络问题。若仍遇问题,建议优先检查镜像地址的可用性,并尝试切换不同服务商的镜像。