Android 2025.2.3 开发环境搭建
准备工作:安装 JDK(>=17) 和 配置JDK环境变量
一、下载 Android Studio
下载最新版:
- 进入 Android Studio 下载页;
- 点击 Download Android Studio 下载最新版。
下载旧版本:
- 进入 Android Studio 旧版下载页;
- 点击“同意条款”;
- 选择一个版本下载。
推荐使用 Android Studio 2025.2.3 版本
二、安装 Android Studio 及配置
2.1 Android Studio 中 Android SDK 设置(推荐)
(1)设置 Android SDK 保存路径
- 首次启动 Android Studio,默认进入 【 Android Studio Setup Wizard 】。
- 在 Android SDK Location 处,建议重新设置 SDK 的保存位置,推荐保存到 【
D:\Android\android-sdk】。 - 点击 Finish,会自动下载相关 SDK 文件。
(2)检查 Android SDK 保存路径
- 在 Android Studio 中,点击菜单栏的 File > Settings。
- 在设置窗口的搜索框中输入 sdk,或依次展开 Languages & Frameworks > Android SDK。
- 在右侧窗格的顶部会看到 Android SDK Location,检查是否为刚才设置的存储位置。
2.2 从 C 盘移动 .gradle 文件夹到 D 盘(推荐)
默认路径是:C:\Users\用户名\.gradle
注:需要把“用户名”替换为实际用户名称。
修改步骤:
- 将
C:\Users\用户名\.gradle剪切并移动到D:\Android\.gradle。 - 以管理员身份打开 CMD,输入以下指令创建目录链接:
1mklink /J C:\Users\用户名\.gradle D:\Android\.gradle
2.3 从 C 盘移动 .android 文件夹到 D 盘(推荐)
默认路径是:C:\Users\用户名\.android
修改步骤:
- 将
C:\Users\用户名\.android剪切并移动到D:\Android\.android。 - 以管理员身份打开 CMD,输入以下指令创建目录链接:
1mklink /J C:\Users\用户名\.android D:\Android\.android
三、Android Studio 中设置第三方 Android 模拟器
-
下载并安装第三方模拟器,例如 MuMu 模拟器。
-
运行模拟器,设置为竖屏显示。
-
将 Android SDK 安装路径下的 platform-tools 文件夹添加到环境变量中,步骤如下:
- 新建环境变量 ANDROID_HOME,值为
D:\Android\android-sdk。 - 在 Path 中增加:
%ANDROID_HOME%\platform-tools。
- 新建环境变量 ANDROID_HOME,值为
-
重启系统,让环境变量生效(此时 cmd 下已支持
adb命令)。 -
在 Android Studio 中新建一个空项目(Empty Views Activity)。
-
打开 cmd 命令行,输入
adb connect 127.0.0.1:7555,测试能否连接上模拟器,Android Studio 会自动识别。 -
运行项目,在模拟器中运行 Hello World 应用。
四、重新设置 gradle 下载路径
Android Studio 下载 gradle 通常很慢,可以替换为国内地址:
- 停止同步(点击 IDE 左下方的停止按键)。
- 找到项目下的
gradle/wrapper/gradle-wrapper.properties文件,找到其中的distributionUrl(不同项目的 gradle 版本号可能不同):
1distributionUrl=https://services.gradle.org/distributions/gradle-9.1.0-bin.zip
- 到腾讯云镜像资源找到对应的 gradle 版本:腾讯云镜像资源。
- 复制链接,替换后的内容如下:
1distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-9.1.0-bin.zip
- 重新同步,等待下载。
五、解决同步下载 gradle-x.xx-src.zip 慢的问题
如果发现同步时还需要下载 gradle-x.xx-src.zip 文件,通常会卡在这里,下载很慢,解决步骤:
- 停止同步。
- 把
gradle-wrapper.properties中的 bin 改成 all,示例:
1distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-9.1.0-all.zip
- 重新同步,等待下载。