Android Studio 安装及 SDK、JDK、Gradle 环境配置指南

四、Gradle 配置

Gradle 负责项目的构建与依赖管理。由于网络原因，国内开发者建议优化下载源。

1. 修改 Gradle 用户目录

Gradle 缓存文件较多，建议将其移至非系统盘。

• 新建系统变量 GRADLE_USER_HOME，指向自定义文件夹。
• 在 Android Studio 设置中确认 Gradle User Home 路径已更新。
• 验证方法：打开新终端，输入 echo %GRADLE_USER_HOME% 查看输出路径。

2. 配置镜像源

为避免下载缓慢或失败，建议将 Gradle 及依赖库地址改为国内镜像。

修改 gradle-wrapper.properties 找到项目中的 gradle-wrapper.properties 文件，将 distributionUrl 修改为腾讯云镜像：

distributionUrl=https://mirrors.cloud.tencent.com/gradle/gradle-8.0-bin.zip

修改 settings.gradle.kts 在 settings.gradle.kts 中添加 Maven 仓库镜像，覆盖默认源：

// 阿里云镜像
maven { setUrl("https://maven.aliyun.com/repository/public/") }
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://repo.huaweicloud.com/repository/maven/") }
// 腾讯云镜像
maven { setUrl("https://mirrors.cloud.tencent.com/nexus/repository/maven-public/") }
// 网易镜像
maven { setUrl("https://mirrors.163.com/maven/repository/maven-public/") }

提示：首次创建项目时，Gradle 会优先检查本地缓存。若本地无匹配版本，则会按上述配置下载。配置镜像源后，构建速度会有显著提升。

五、新项目测试

环境配置完成后，创建一个新项目验证流程。

1. 构建速度：观察控制台日志，若显示 UP-TO-DATE，说明任务已执行过且无需更新，构建时间通常在 10 秒左右。
2. 运行应用：创建或选择一个虚拟设备（AVD），切换至该设备后点击运行按钮。
3. 启动模拟器：等待模拟器加载完成，即可看到应用界面。