Android Studio 安装及核心组件配置指南（SDK、JDK、Gradle）

Gradle 用户目录默认位于 C 盘，存储大量缓存文件，建议修改路径以便管理。

1. 修改 Gradle User Home

   • 新建文件夹作为 Gradle 用户目录。
   • 设置环境变量 GRADLE_USER_HOME 指向该路径。
   • 在 IDE 的 Gradle 设置中确认路径已更新，并将默认的 JBR 切换为配置的 JDK 路径。

2. 配置国内镜像源 网络波动常导致构建失败，修改下载源可显著提升速度。

   • 修改 gradle-wrapper.properties 中的 distributionUrl 为腾讯云镜像：

   distributionUrl=https://mirrors.cloud.tencent.com/gradle/
   

   • 修改 settings.gradle.kts 中的仓库地址，覆盖 Maven Central 等默认源：

   // 阿里云镜像
   maven { url = uri("https://maven.aliyun.com/repository/public/") }
   maven { url = uri("https://maven.aliyun.com/repository/google/") }
   // 华为云镜像
   maven { url = uri("https://repo.huaweicloud.com/repository/maven/") }
   // 腾讯云镜像
   maven { url = uri("https://mirrors.cloud.tencent.com/nexus/repository/maven-public/") }
   

注意：首次创建项目时，Gradle 会优先检查本地缓存。若缓存命中则直接使用，否则按上述配置下载。配置镜像后，构建时间显著缩短，稳定性大幅提升。

五、新项目测试

1. 验证构建速度 创建新工程后观察构建日志，UP-TO-DATE 状态表明任务无需重复执行，构建效率明显提升。

2. 运行模拟器 创建虚拟设备并启动，切换至对应 API 版本即可正常调试运行。