Android 开发环境搭建

September 15, 2025

本文档将指导您如何在本地搭建 Android 开发环境，并创建您的第一个 Android 项目。

下载 Android Studio

首先，您需要下载 Android Studio，这是 Google 官方推荐的集成开发环境（IDE），专门用于开发 Android 应用。

访问 Android Studio 官方下载页面。
根据您的操作系统选择合适的版本（Windows、macOS 或 Linux）。

安装 Android Studio 指南

下载完成后，请按照以下步骤进行安装

下载完成后，开始安装 Android Studio。安装过程中，您将安装 Android SDK、Android Virtual Device（AVD）以及其他必要的工具。

第一步：启动安装程序

安装向导第一步

点击 Next 进入下一步

第二步：选择组件

选择安装组件

Android Virtual Device: 按需选择是否安装
提示：如果暂时不需要使用模拟器，可以取消勾选以节省磁盘空间和安装时间

点击 Next 继续

第三步：选择安装位置

选择安装路径

选择 Android Studio 的安装路径后点击 Next

第四步：确认安装

开始安装

点击 Install 开始安装

第五步：安装进行中

安装进度

等待安装进度完成，然后点击 Next

第六步：完成安装

安装完成

点击 Finish 完成安装并启动 Android Studio

第七步：初始设置

欢迎界面

点击 Next 继续初始设置

第八步：安装类型选择

安装类型选择

Standard: 标准安装（SDK 默认安装在 C 盘）
Custom: 自定义安装（推荐）
建议选择 Custom，可将 SDK 安装到其他分区，避免后续开发文件占用过多系统盘空间

第九步：自定义 SDK 设置

SDK设置

Android Virtual Device: 按需选择是否安装模拟器
Performance: 按需选择性能监控工具
Android SDK Location: 设置 SDK 安装路径（建议选择非系统盘）

点击 Next 继续

第十步：确认设置

确认设置

检查设置无误后，点击 Next

第十一步：下载组件

下载组件

点击 Finish 开始下载必要的 SDK 组件

第十二步：安装完成

安装完成

🎉 恭喜！Android Studio 已成功安装完成

（可选）修改 Gradle User Home 路径

此步骤非安装向导内容，但对管理磁盘空间至关重要。Gradle 会在用户目录（C:\Users[用户名].gradle）下缓存所有项目的依赖库，长期开发会占用大量 C 盘空间。

打开环境变量设置（Win键 - 搜索’环境’ - 高级 - 环境变量 - 系统变量 - 新建）
新建系统变量 - 变量名（GRADLE_USER_HOME） - 变量值（希望Gradle存放的路径）

(可选) 设置ANDROID_USER_HOME环境变量

此步骤非安装向导内容，但对管理磁盘空间至关重要。该环境变量为 Android SDK 中包含的工具设置用户偏好设置目录的路径。默认为 $HOME/.android/。创建的虚拟设备会存放在该路径下，虚拟设备越多占用 C 盘空间越多。

新建系统变量 - 变量名（ANDROID_USER_HOME） - .android路径环境变量

Android系统镜像有时候下载很慢，我是直接获取镜像下载路径用idm下载(https://dl.google.com/android/repository/sys-img/google_apis_playstore/x86_64-36_r07.zip)，下载完成后将压缩包解压到 E:\Program Files\Android\Sdk\system-images\android-36\google_apis_playstore下，之后重启Android Studio就识别到了,E:\Program Files\Android\Sdk为Android SDK 路径。

创建第一个项目

New Project

配置Gradle镜像和maven远程库

项目打开后我们先不着急让Android Studio下载 Gradle 和 远程依赖, 先点击x停止。有些资源是国外了，国内访问速度可能受限，配置镜像可以帮助我们更快地加载项目。

配置Gradle镜像

找到gradle-wrapper.properties文件, 在腾讯Gradle镜像中找到自己项目版本的Gradle, 并对distributionUrl地址进行替换

注意: 选择all版本

配置maven

找到settings.gradle.kts文件，在阿里云Maven镜像按需求添加镜像。

pluginManagement {
    repositories {
        google {
            content {
                includeGroupByRegex("com\\.android.*")
                includeGroupByRegex("com\\.google.*")
                includeGroupByRegex("androidx.*")
            }
        }
        gradlePluginPortal()
        maven {
            url = uri("https://maven.aliyun.com/repository/gradle-plugin")
        }
    }
}
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        maven {
            url = uri("https://maven.aliyun.com/repository/public")
        }
    }
}

陈靖文