Android 2025.2.3 开发环境搭建

准备工作:安装 JDK(>=17)配置JDK环境变量

一、下载 Android Studio

下载最新版:

  1. 进入 Android Studio 下载页
  2. 点击 Download Android Studio 下载最新版。

下载旧版本:

  1. 进入 Android Studio 旧版下载页
  2. 点击“同意条款”;
  3. 选择一个版本下载。

推荐使用 Android Studio 2025.2.3 版本

二、安装 Android Studio 及配置

参考Android Studio 2024 详细图文安装步骤

2.1 Android Studio 中 Android SDK 设置(推荐)

(1)设置 Android SDK 保存路径

  1. 首次启动 Android Studio,默认进入 【 Android Studio Setup Wizard 】
  2. Android SDK Location 处,建议重新设置 SDK 的保存位置,推荐保存到 【D:\Android\android-sdk】。
  3. 点击 Finish,会自动下载相关 SDK 文件。

(2)检查 Android SDK 保存路径

  1. 在 Android Studio 中,点击菜单栏的 File > Settings
  2. 在设置窗口的搜索框中输入 sdk,或依次展开 Languages & Frameworks > Android SDK
  3. 在右侧窗格的顶部会看到 Android SDK Location,检查是否为刚才设置的存储位置。

2.2 从 C 盘移动 .gradle 文件夹到 D 盘(推荐)

默认路径是:C:\Users\用户名\.gradle

注:需要把“用户名”替换为实际用户名称。

修改步骤:

  1. C:\Users\用户名\.gradle 剪切并移动到 D:\Android\.gradle
  2. 以管理员身份打开 CMD,输入以下指令创建目录链接:
1mklink /J C:\Users\用户名\.gradle D:\Android\.gradle

2.3 从 C 盘移动 .android 文件夹到 D 盘(推荐)

默认路径是:C:\Users\用户名\.android

修改步骤:

  1. C:\Users\用户名\.android 剪切并移动到 D:\Android\.android
  2. 以管理员身份打开 CMD,输入以下指令创建目录链接:
1mklink /J C:\Users\用户名\.android D:\Android\.android

三、Android Studio 中设置第三方 Android 模拟器

  1. 下载并安装第三方模拟器,例如 MuMu 模拟器

  2. 运行模拟器,设置为竖屏显示。

  3. 将 Android SDK 安装路径下的 platform-tools 文件夹添加到环境变量中,步骤如下:

    1. 新建环境变量 ANDROID_HOME,值为 D:\Android\android-sdk
    2. 在 Path 中增加:%ANDROID_HOME%\platform-tools
  4. 重启系统,让环境变量生效(此时 cmd 下已支持 adb 命令)。

  5. 在 Android Studio 中新建一个空项目(Empty Views Activity)。

  6. 打开 cmd 命令行,输入 adb connect 127.0.0.1:7555,测试能否连接上模拟器,Android Studio 会自动识别。

  7. 运行项目,在模拟器中运行 Hello World 应用。

四、重新设置 gradle 下载路径

Android Studio 下载 gradle 通常很慢,可以替换为国内地址:

  1. 停止同步(点击 IDE 左下方的停止按键)。
  2. 找到项目下的 gradle/wrapper/gradle-wrapper.properties 文件,找到其中的 distributionUrl(不同项目的 gradle 版本号可能不同):
1distributionUrl=https://services.gradle.org/distributions/gradle-9.1.0-bin.zip
  1. 到腾讯云镜像资源找到对应的 gradle 版本:腾讯云镜像资源
  2. 复制链接,替换后的内容如下:
1distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-9.1.0-bin.zip
  1. 重新同步,等待下载。

五、解决同步下载 gradle-x.xx-src.zip 慢的问题

如果发现同步时还需要下载 gradle-x.xx-src.zip 文件,通常会卡在这里,下载很慢,解决步骤:

  1. 停止同步。
  2. gradle-wrapper.properties 中的 bin 改成 all,示例:
1distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-9.1.0-all.zip
  1. 重新同步,等待下载。