Android Studio安装及组件配置（SDK、JDK、Gradle）

最新推荐文章于 2025-11-14 10:16:32 发布

原创最新推荐文章于 2025-11-14 10:16:32 发布 · 1.3k 阅读

CC 4.0 BY-SA版权

文章标签：

2025年最新版 Android Studio 及其核心组件（SDK, JDK, Gradle）的安装与配置指南。整个过程主要分为安装IDE、配置核心组件以及优化构建环境三大步骤。

为了让你对安装流程一目了然，下面是整个安装与配置过程的步骤图：

获取安装程序
- 访问 Android Studio 官网（developer.android.google.cn/studio）下载最新版本的安装程序。
- 为避免权限问题，建议不要将安装路径设置在系统盘（如C盘）根目录下。
完成初始设置
- 首次运行时，若遇到无法连接到Google服务器获取SDK组件列表的情况，可以先点击Cancel取消。
- 在接下来的设置类型中，选择 "Custom"（自定义） ，这样可以更灵活地配置组件和路径，避免将所有文件都下载到C盘。

修改安装路径：在初始设置的自定义阶段，将默认的SDK路径修改到你指定的非系统盘目录。
安装SDK：选择你需要的SDK版本（例如，默认可能是Android API 35），同意许可协议后开始下载安装。
配置环境变量（非必需但推荐）：为了方便在命令行或其他环境中使用SDK工具，可以设置系统环境变量。
- 新建系统变量 ANDROID_HOME，值为你的SDK安装路径。
- 在 Path 变量中添加 %ANDROID_HOME%\tools 和 %ANDROID_HOME%\platform-tools。

关于JDK，你有两个主流选择，绝大多数情况下，使用Android Studio自带的JDK是更省心的方案。

配置方案	说明	适用场景
使用内置JBR	Android Studio自带JetBrains运行时(JBR)，安装后开箱即用。	推荐大多数开发者，兼容性和稳定性有保障。
安装自定义JDK	可从Oracle官网或AdoptOpenJDK下载，例如目前较新且稳定的JDK 17。	需要特定JDK版本或有统一环境管理需求的用户。

如果你选择安装自定义JDK，安装后需要配置系统环境变量：

注：无论采用哪种方式，用于运行Gradle构建的JDK版本必须满足Android Gradle插件(AGP)的要求。例如，AGP 8.x 需要JDK 17。你可以在项目结构设置中指定Gradle使用的JDK。

Gradle虽然会随Android Studio一起安装或在首次构建项目时自动下载，但进行一些配置可以显著提升体验。

修改Gradle用户目录（推荐）
- Gradle用户目录会缓存大量文件。你可以新建一个系统变量 GRADLE_USER_HOME，将其值设置到非系统盘的指定路径，从而释放C盘空间并方便管理。
使用国内镜像源加速
- 为了解决Gradle及依赖库下载缓慢或失败的问题，强烈建议将下载源更换为国内镜像。
- 修改Gradle包装器：打开项目下的 gradle-wrapper.properties 文件，将 distributionUrl 替换为国内镜像地址，例如腾讯云镜像：https://mirrors.cloud.tencent.com/gradle/gradle-x.x-all.zip。
- 修改依赖库源：打开项目根目录下的 settings.gradle.kts（或 settings.gradle）文件，在 dependencyResolutionManagement 块中添加阿里云、华为云等镜像仓库。
kotlin
```
// 以阿里云镜像为例
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/") }
```