Android Studio 安装与核心组件配置指南
原生 Android 开发环境概览
Android 是由 Google 开发的移动操作系统,"原生 Android 开发"指的是直接使用 Java 或 Kotlin 语言,以及 Android SDK,来为这个操作系统构建应用程序。这是深耕 Android 生态、追求极致性能和系统集成的选择。
在安装之前,我们需要明确以下核心组件,它们是 Android 开发生态的基础:
| 组件/配置 | 备注 |
|---|---|
| Android Studio | 开发 Android 应用的首选 IDE |
| Android SDK | Android 平台工具和库(初始设置时会提示下载) |
| JDK | Java 开发环境,用于运行 Android SDK 工具 |
| Gradle | Android 项目构建工具(通常随 IDE 一起安装或首次构建时自动下载) |
一、Android Studio 安装流程
首先从官网获取安装包。进入 Android Studio 官网后,点击 Download 按钮。
[图示] 点击下载页面,选择对应操作系统的版本。
安装向导启动后,一路点击 Next 即可。在路径选择环节,建议修改默认路径,避免将文件安装在 C 盘,方便后续管理。
[图示] 自定义安装路径选择界面。
确认选项后开始安装。等待进度条走完,程序会自动解压并配置基础环境。
[图示] 安装完成后的欢迎界面。
首次打开时,可能会提示无法连接到 Google 服务器获取 SDK 列表,这是国内网络环境的常见现象,直接点击 Cancel 跳过即可,后续可以在设置中手动配置。
接着选择设置类型,建议选择 Custom(自定义),这样可以更灵活地控制 SDK 和组件的存储位置。
[图示] 自定义设置选项。
二、Android SDK 配置
SDK 是 Android 开发的核心依赖。安装完成后,我们需要确保 SDK 路径正确。
1. 修改 SDK 文件路径
在欢迎界面或设置中,可以找到 SDK Location 选项。默认情况下会下载最新的 API 版本(如 Android 15 / API 35)。建议根据实际开发需求调整,或者保持默认以获取最新特性。
[图示] SDK 路径设置界面。
同意协议后,点击 Apply 或 Finish,IDE 会自动下载所需的 SDK 组件。等待下载完成,状态显示 Success 即表示配置成功。
[图示] SDK 下载进度及完成状态。
2. 配置环境变量(可选)
如果需要在命令行或其他非 Android Studio 环境中访问 SDK 工具,可以配置环境变量。
- 右键"此电脑" -> "属性" -> "高级系统设置" -> "环境变量"。
- 新建系统变量:名称
ANDROID_HOME,值设为 SDK 的文件路径。 - 编辑 Path 变量,添加以下两条:
%ANDROID_HOME%\tools %ANDROID_HOME%\platform-tools
三、JDK 配置(选做)
对于大多数开发者而言,使用 Android Studio 自带的 JBR(JetBrains Runtime)完全能满足日常需求,开箱即用且兼容性良好。但为了环境的统一性或特定需求,也可以手动配置 JDK。
目前推荐使用较新且成熟的 JDK 17。如果你决定手动配置,步骤如下:
1. 下载与解压
前往 Oracle 官网或 Adoptium 下载 JDK 17 安装包。下载后解压到指定目录。
[图示] JDK 下载页面及解压后的文件夹结构。
2. 配置环境变量
同样在"环境变量"设置中:
- 新建系统变量:名称
JAVA_HOME,值设为 JDK 的安装路径。 - 编辑 Path 变量,添加
%JAVA_HOME%\bin,并将其上移至顶端以避免冲突。
[图示] JAVA_HOME 及 Path 配置界面。
3. 验证生效
打开命令提示符,输入以下命令:
java -version
若输出版本信息,说明配置成功。
[图示] 终端输出 java 版本号。
四、Gradle 配置优化
Gradle 负责项目的构建与依赖管理。在国内环境下,优化 Gradle 的配置能显著提升下载速度和稳定性。
1. 修改 Gradle User Home 路径
Gradle 的用户目录会缓存大量构建文件,默认位于 C 盘,建议修改到其他分区。
- 新建一个文件夹作为 Gradle 用户目录。
- 在环境变量中新建
GRADLE_USER_HOME,指向该文件夹。 - 验证方法:打开新的命令行窗口,输入
echo %GRADLE_USER_HOME%,应输出刚才设置的路径。
[图示] 环境变量 GRADLE_USER_HOME 设置。
在 Android Studio 内部,找到 Gradle 设置项,将默认的 JBR 修改为我们配置的 JDK 路径,并将 User Home 指向自定义目录。
[图示] IDE 内 Gradle 配置界面。
2. 配置国内镜像源
为了避免下载速度慢或失败,强烈建议将 Gradle 和 Maven 仓库地址替换为国内镜像。
修改 Gradle Wrapper
在项目创建后,找到 gradle-wrapper.properties 文件,修改 distributionUrl 为国内镜像地址,例如腾讯云:
distributionUrl=https://mirrors.cloud.tencent.com/gradle/gradle-8.x-bin.zip
[图示] gradle-wrapper.properties 文件内容。
修改 Maven 仓库源
在项目的 settings.gradle.kts 文件中,添加阿里云、华为云或腾讯云的 Maven 仓库配置。以下是一个综合示例:
// 阿里云镜像
maven { url = uri("https://maven.aliyun.com/repository/public/") }
maven { url = uri("https://maven.aliyun.com/repository/google/") }
maven { url = uri("https://maven.aliyun.com/repository/jcenter/") }
maven { url = uri("https://maven.aliyun.com/repository/gradle-plugin/") }
// 华为云镜像
maven { url = uri("https://repo.huaweicloud.com/repository/maven/") }
// 腾讯云镜像
maven { url = uri("https://mirrors.cloud.tencent.com/nexus/repository/maven-public/") }
// 网易镜像
maven { url = uri("https://mirrors.163.com/maven/repository/maven-public/") }
[图示] settings.gradle.kts 修改前后对比。
首次创建项目时,Gradle 会优先检查本地缓存。如果本地没有匹配版本,会从上述配置的地址下载。配置镜像源后,加载速度会有明显提升。
五、新项目测试
环境搭建完毕后,创建一个新项目进行验证。
1. 创建项目
在欢迎界面点击 New Project,按照向导填写包名、项目名称等信息。此时 Gradle 会根据配置开始下载依赖。
[图示] 新建项目向导界面。
2. 运行验证
选择一台可用的模拟器或连接真机。点击 Run 按钮,观察控制台日志。
- UP-TO-DATE 表示任务已执行过且无变更,会跳过重新构建,速度极快。
- 若看到 Daemon 启动成功且应用正常安装到设备,说明环境配置无误。
[图示] 模拟器启动及应用运行界面。
至此,Android Studio 开发环境已准备就绪,可以开始编写代码了。


