Android Studio 安装与环境变量配置全攻略 – wiki基地


Android Studio 安装与环境变量配置全攻略:从零开始构建你的安卓开发环境

在当今移动互联网时代,Android 应用开发无疑是技术领域的热门赛道。而作为 Android 应用开发的官方 IDE (集成开发环境),Android Studio 凭借其强大的功能、完善的工具链以及与 Google 官方生态的紧密结合,成为了无数开发者首选的开发利器。然而,对于初学者来说,Android Studio 的安装与环境变量的配置过程可能会显得有些复杂,稍有不慎就可能导致环境搭建失败,从而耽误宝贵的学习和开发时间。

本篇文章将为您提供一份详尽至极的 Android Studio 安装与环境变量配置全攻略,从环境准备、JDK 安装、Android Studio 下载与安装,到核心环境变量的配置(JAVA_HOME、ANDROID_HOME、Path)以及常见问题的排查,每一步都将进行细致入微的讲解,并涵盖 Windows、macOS 和 Linux 三大主流操作系统,确保您能顺利、高效地搭建起属于自己的 Android 开发环境。


第一章:踏上征途前的准备——软硬件与心态

在正式开始安装之前,我们需要做好一些基础的准备工作,这就像建造一座大厦前需要打好地基一样重要。

1.1 硬件要求与建议

虽然 Android Studio 对硬件的要求不像游戏那样苛刻,但为了保证开发的流畅性,避免卡顿和漫长的编译等待,我们强烈建议您的设备满足以下条件:

  • 操作系统:
    • Windows: Windows 8/10/11 (64位)
    • macOS: macOS 10.14 (Mojave) 或更高版本
    • Linux: GNOME、KDE 或 Unity DE 的 64 位发行版 (例如 Ubuntu 18.04 LTS 或更高版本)
  • 内存 (RAM):
    • 最低: 8 GB RAM (Android Studio 自身 + 模拟器)
    • 推荐: 16 GB RAM 或更高 (特别是当您需要同时运行多个应用或虚拟机时)
  • 硬盘空间:
    • 最低: 8 GB 可用空间 (IDE + Android SDK + 模拟器系统镜像)
    • 推荐: 128 GB SSD (固态硬盘) 或更高。SSD 的读写速度远超 HDD (机械硬盘),能显著提升启动、编译和模拟器运行速度。
  • 屏幕分辨率: 1280 x 800 或更高。
  • 处理器 (CPU):
    • 最低: 64 位处理器。
    • 推荐: 支持 Intel VT-x、Intel EM64T (Intel 处理器) 或 AMD-V (AMD 处理器) 的多核处理器。这些虚拟化技术对运行 Android 模拟器至关重要。

1.2 网络连接

整个安装过程中,尤其是下载 Android SDK 组件时,需要稳定且速度较快的互联网连接。因为 Android SDK 组件文件通常较大,且数量繁多。

1.3 保持耐心与细致

安装和配置环境变量可能涉及一些命令行操作和系统设置,务必按照本教程的步骤一步一步来,仔细核对每一步的路径和命令,保持耐心。


第二章:核心基石——Java Development Kit (JDK) 的安装与 JAVA_HOME 配置

Android Studio 是基于 Java 开发的,同时 Android 应用的构建也依赖于 Java 环境。因此,在安装 Android Studio 之前,我们必须先安装 Java Development Kit (JDK),并正确配置其环境变量 JAVA_HOME

2.1 选择合适的 JDK 版本

过去,Oracle JDK 是主流选择,但自 JDK 11 之后,Oracle JDK 的商业使用需要付费许可。对于个人学习和开发,我们推荐使用OpenJDK。例如,Adoptium OpenJDK (原 AdoptOpenJDK) 是一个非常受欢迎且稳定的 OpenJDK 发行版。

  • 推荐版本: OpenJDK 11 或 OpenJDK 17。Android Studio 的最新版本通常推荐使用这些 LTS (长期支持) 版本。

2.2 下载 JDK

访问 Adoptium 官网:https://adoptium.net/

  1. 在首页选择您需要的 JDK 版本 (例如 Temurin 17 (LTS)Temurin 11 (LTS))。
  2. 确保操作系统和架构与您的设备匹配 (例如 x64)。
  3. 下载对应的安装包:
    • Windows: msi 安装包 (推荐)
    • macOS: pkg 安装包
    • Linux: tar.gz 压缩包

2.3 安装 JDK

2.3.1 Windows 用户
  1. 双击下载的 msi 安装包,启动安装向导。
  2. 一路点击“Next”或“下一步”,直到安装完成。请记下 JDK 的安装路径,通常是 C:\Program Files\Eclipse Adoptium\jdk-xx.x.x.xxx (xx.x.x.xxx 是版本号)。
    • 重要提示: 在某个步骤中,安装程序可能会询问是否设置 JAVA_HOME 环境变量。如果您选择设置,后续可以跳过手动配置 JAVA_HOME 的步骤。但为了教学的完整性和理解原理,本文仍会详细讲解手动配置。
2.3.2 macOS 用户
  1. 双击下载的 pkg 安装包,启动安装向导。
  2. 按照提示点击“继续”、“安装”,输入您的系统密码,直到安装完成。
  3. macOS 上的 JDK 通常安装在 /Library/Java/JavaVirtualMachines/jdk-xx.x.x.jdk/Contents/Home 目录下。
2.3.3 Linux 用户
  1. 将下载的 tar.gz 压缩包解压到您希望安装 JDK 的位置。通常推荐解压到 /usr/local/java/ 或您的用户主目录下的某个目录。
    bash
    # 例如解压到 /usr/local/java/ (需要管理员权限)
    sudo mkdir -p /usr/local/java
    sudo tar -zxvf /path/to/your/jdk-xx.x.x_linux-x64_bin.tar.gz -C /usr/local/java/
    # 解压后,会生成一个类似 jdk-xx.x.x 的目录
    # 比如:/usr/local/java/jdk-17.0.x

2.4 配置 JAVA_HOME 环境变量

JAVA_HOME 环境变量指向 JDK 的安装根目录,许多 Java 应用程序(包括 Android Studio)会通过它来查找 Java 环境。

2.4.1 Windows 用户
  1. 打开系统环境变量设置:
    • 右键点击“此电脑”或“我的电脑” -> “属性” -> “高级系统设置” -> “环境变量”。
    • 或者在搜索栏中输入“环境变量”,选择“编辑系统环境变量”。
  2. 新建 JAVA_HOME 变量:
    • 在“系统变量”区域,点击“新建…”按钮。
    • 变量名:JAVA_HOME
    • 变量值:填写您 JDK 的安装路径,例如 C:\Program Files\Eclipse Adoptium\jdk-17.0.x.xxx
    • 点击“确定”。
  3. 编辑 Path 变量:
    • 在“系统变量”区域,找到名为 Path 的变量,双击或点击“编辑”。
    • 点击“新建”,添加 %JAVA_HOME%\bin
    • 点击“确定”,直到关闭所有环境变量窗口。
  4. 验证:
    • 打开 新的 命令提示符 (CMD) 或 PowerShell 窗口(旧窗口可能不会立即刷新环境变量)。
    • 输入命令:java -version
    • 如果显示 JDK 的版本信息,说明配置成功。
    • 输入命令:javac -version
    • 如果也显示版本信息,则更进一步确认配置无误。
2.4.2 macOS 用户

macOS 下 JDK 的安装通常会自动配置好,但为了确保或手动配置,可以这样做:

  1. 确定 JDK 路径:
    bash
    /usr/libexec/java_home -v 1.8 # 检查Java 8的路径
    /usr/libexec/java_home -v 11 # 检查Java 11的路径
    /usr/libexec/java_home -v 17 # 检查Java 17的路径

    您会得到一个路径,例如 /Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home
  2. 编辑配置文件: 打开终端,编辑您的 Shell 配置文件。常用的有 ~/.bash_profile (对于 Bash 用户) 或 ~/.zshrc (对于 Zsh 用户,macOS Catalina 及以上版本默认)。
    bash
    # 如果是 Bash
    nano ~/.bash_profile
    # 如果是 Zsh
    nano ~/.zshrc
  3. 添加或修改内容: 在文件末尾添加以下两行(将 jdk-xx.x.x.jdk 替换为您的实际 JDK 目录名):
    bash
    export JAVA_HOME=$(/usr/libexec/java_home -v 17) # 根据您安装的JDK版本修改
    export PATH=$JAVA_HOME/bin:$PATH

    或者直接指定路径:
    bash
    export JAVA_HOME=/Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home
    export PATH=$JAVA_HOME/bin:$PATH

    保存并退出 (Nano 编辑器:Ctrl+O 回车,Ctrl+X 退出)。
  4. 使配置生效: 在终端中执行以下命令,或者重新打开一个终端窗口:
    bash
    source ~/.bash_profile # 如果是 Bash
    source ~/.zshrc # 如果是 Zsh
  5. 验证:
    • 在终端中输入:echo $JAVA_HOME
    • 输入:java -version
    • 输入:javac -version
    • 如果显示正确路径和版本信息,则配置成功。
2.4.3 Linux 用户
  1. 确定 JDK 路径: 假设您将 JDK 解压到了 /usr/local/java/jdk-17.0.x
  2. 编辑配置文件: 与 macOS 类似,通常是 ~/.bashrc~/.zshrc (对于个人用户) 或 /etc/profile (对于所有用户)。推荐编辑您用户目录下的配置文件。
    bash
    nano ~/.bashrc # 或 ~/.zshrc
  3. 添加或修改内容: 在文件末尾添加以下两行(将路径替换为您的实际 JDK 目录):
    bash
    export JAVA_HOME=/usr/local/java/jdk-17.0.x
    export PATH=$JAVA_HOME/bin:$PATH

    保存并退出。
  4. 使配置生效:
    bash
    source ~/.bashrc # 或 source ~/.zshrc
  5. 验证:
    • 在终端中输入:echo $JAVA_HOME
    • 输入:java -version
    • 输入:javac -version
    • 如果显示正确路径和版本信息,则配置成功。

第三章:拥抱开发神器——Android Studio 的下载与安装

JDK 环境配置完毕后,我们就可以着手安装 Android Studio 了。

3.1 下载 Android Studio

访问 Android 开发者官网:https://developer.android.com/studio

  1. 点击页面中央的“Download Android Studio”按钮。
  2. 阅读并同意用户协议。
  3. 根据您的操作系统选择对应的下载包。
    • Windows: exe 安装程序
    • macOS: dmg 磁盘映像文件
    • Linux: tar.gz 压缩包

3.2 安装 Android Studio

3.2.1 Windows 用户
  1. 双击下载的 android-studio-xxx-windows.exe 安装包,启动安装向导。
  2. 选择组件: 确保勾选“Android Virtual Device” (AVD,即 Android 模拟器) 和 “Android SDK” (如果默认未勾选)。
  3. 安装位置: 可以使用默认路径(通常在 C:\Program Files\Android\Android Studio),也可以自定义。请记住这个路径。
  4. 开始菜单文件夹: 保持默认即可。
  5. 点击“Install”开始安装。
  6. 安装完成后,勾选“Start Android Studio”并点击“Finish”启动。
3.2.2 macOS 用户
  1. 双击下载的 android-studio-xxx.dmg 文件,会打开一个窗口。
  2. 将 Android Studio 图标拖拽到“Applications”文件夹中。
  3. 关闭 DMG 窗口,并可以将其弹出。
  4. 从“Applications”文件夹中找到 Android Studio 并双击启动。首次启动时,可能会提示“此应用来自互联网,是否确定打开?”,点击“打开”。
3.2.3 Linux 用户
  1. 将下载的 android-studio-xxx-linux.tar.gz 压缩包解压到您希望安装的位置。通常推荐解压到 /opt/ 或您的用户主目录下。
    bash
    # 例如解压到用户主目录下
    tar -zxvf /path/to/your/android-studio-xxx-linux.tar.gz -C ~/
    # 解压后会得到一个名为 android-studio 的目录
  2. 进入解压后的 android-studio/bin 目录:
    bash
    cd ~/android-studio/bin
  3. 执行脚本启动 Android Studio:
    bash
    ./studio.sh

    • 可选:创建桌面快捷方式或添加到 PATH: 启动后,Android Studio 会提示您是否创建桌面快捷方式。或者您也可以手动将 ~/android-studio/bin 添加到 PATH 环境变量中,方便直接在终端输入 studio.sh 启动。

3.3 首次启动与配置向导

无论是哪个操作系统,首次启动 Android Studio 都会进入配置向导:

  1. Import settings from a previous installation?
    • 如果您是首次安装,选择“Do not import settings”。
  2. Data Sharing: 询问是否向 Google 发送使用数据,选择您偏好的选项。
  3. Setup Wizard:
    • Installation Type: 强烈推荐选择 “Standard” (标准安装)。它会为您安装推荐的 Android SDK 组件、最新版本的 Android SDK Platform-Tools、Android SDK Build-Tools、Android Emulator 等。如果您是高级用户,才选择“Custom”来自定义组件。
    • UI Theme: 选择您喜欢的界面主题 (Light 或 Darcula)。
    • Verify Settings: 确认您的设置,会显示将要下载的组件列表和总大小。确保您的网络连接良好,并且有足够的磁盘空间。
    • Downloading Components: Android Studio 会开始下载和安装所选的 SDK 组件。这个过程可能需要较长时间,取决于您的网络速度和组件大小。请耐心等待。
    • Finish: 组件下载安装完毕后,点击“Finish”完成设置。
  4. 现在,您将看到 Android Studio 的欢迎界面,表示安装成功!

第四章:高级配置——Android SDK 与环境变量配置

虽然 Android Studio 安装过程中会自动下载和配置 SDK,但为了确保命令行工具的可用性,以及某些第三方工具的兼容性,我们强烈建议手动配置 ANDROID_HOME 和更新 Path 环境变量。

4.1 查找 Android SDK 路径

在 Android Studio 中,您可以很容易地找到 SDK 的安装路径:

  1. 在 Android Studio 欢迎界面,点击右下角的“Configure” -> “SDK Manager”。
  2. 或者在打开项目后,点击菜单栏的 File -> Settings (Windows/Linux) 或 Android Studio -> Preferences (macOS)。
  3. 在弹出的窗口中,找到 Appearance & Behavior -> System Settings -> Android SDK
  4. “Android SDK Location” 就是您的 SDK 根目录。请记住或复制这个路径。
    • Windows 典型路径: C:\Users\YourUsername\AppData\Local\Android\sdk (AppData 是隐藏文件夹)
    • macOS 典型路径: ~/Library/Android/sdk/Users/YourUsername/Library/Android/sdk
    • Linux 典型路径: ~/Android/sdk/home/YourUsername/Android/sdk

4.2 配置 ANDROID_HOME 环境变量

ANDROID_HOME 环境变量指向 Android SDK 的根目录,类似于 JAVA_HOME

4.2.1 Windows 用户
  1. 打开系统环境变量设置: (参考 2.4.1 节)
  2. 新建 ANDROID_HOME 变量:
    • 在“系统变量”区域,点击“新建…”按钮。
    • 变量名:ANDROID_HOME
    • 变量值:填写您 Android SDK 的安装路径,例如 C:\Users\YourUsername\AppData\Local\Android\sdk
    • 点击“确定”。
  3. 编辑 Path 变量(添加 SDK 工具路径):
    • 在“系统变量”区域,找到名为 Path 的变量,双击或点击“编辑”。
    • 点击“新建”,添加以下三个路径:
      • %ANDROID_HOME%\platform-tools (包含 adb 等重要工具)
      • %ANDROID_HOME%\tools (包含 android 命令,尽管较少使用)
      • %ANDROID_HOME%\cmdline-tools\latest\bin (新版 SDK 工具,包含 sdkmanager 等)
    • 确保这些路径的顺序无碍,一般放在 Path 变量的末尾即可。
    • 点击“确定”,直到关闭所有环境变量窗口。
  4. 验证:
    • 打开 新的 命令提示符 (CMD) 或 PowerShell 窗口。
    • 输入命令:adb version
    • 如果显示 Android Debug Bridge version 等信息,说明 platform-tools 配置成功。
    • 输入命令:sdkmanager --list
    • 如果显示 SDK 组件列表,说明 cmdline-tools 配置成功。
4.2.2 macOS / Linux 用户
  1. 确定 Android SDK 路径: (参考 4.1 节)
    例如:/Users/YourUsername/Library/Android/sdk~/Android/sdk
  2. 编辑配置文件: 打开终端,编辑您的 Shell 配置文件 (例如 ~/.bash_profile~/.zshrc~/.bashrc)。
    bash
    nano ~/.zshrc # 例如,如果您使用 Zsh
  3. 添加或修改内容: 在文件末尾添加以下行(将路径替换为您的实际 SDK 目录):
    bash
    export ANDROID_HOME=/Users/YourUsername/Library/Android/sdk # 根据您的实际SDK路径修改
    export PATH=$PATH:$ANDROID_HOME/platform-tools
    export PATH=$PATH:$ANDROID_HOME/tools
    export PATH=$PATH:$ANDROID_HOME/cmdline-tools/latest/bin # 如果有此目录

    保存并退出。
  4. 使配置生效: 在终端中执行以下命令,或者重新打开一个终端窗口:
    bash
    source ~/.zshrc # 根据您的配置文件修改
  5. 验证:
    • 在终端中输入:echo $ANDROID_HOME
    • 输入:adb version
    • 输入:sdkmanager --list
    • 如果显示正确路径和版本信息,则配置成功。

第五章:优化与常见问题排查

即使严格按照上述步骤操作,有时也可能遇到一些小插曲。本章将提供一些优化建议和常见问题的解决方案。

5.1 优化 Android 模拟器 (AVD) 性能

模拟器运行缓慢是初学者常见的问题。确保您的设备启用了硬件加速虚拟化技术。

  • Intel 处理器 (Windows/Linux):
    • 在 BIOS/UEFI 设置中启用 Intel VT-x 或 VMX。
    • 在 Android Studio 的 SDK Manager 中,确保安装了 Intel x86 Emulator Accelerator (HAXM installer)
    • 安装 HAXM 后,需要手动运行其安装程序(通常在 SDK_LOCATION\extras\intel\Hardware_Accelerated_Execution_Manager\intelhaxm-android.exe)。
  • AMD 处理器 (Windows/Linux):
    • 在 BIOS/UEFI 设置中启用 AMD-V 或 SVM。
    • 在 Windows 上,确保已启用 Hyper-V 功能(“控制面板” -> “程序和功能” -> “启用或关闭 Windows 功能”)。或者,如果遇到冲突,可以禁用 Hyper-V 以便 HAXM 工作,或者使用 Android Emulator Hypervisor Driver for AMD Processors。
  • macOS:
    • macOS 上的模拟器通常直接使用 Hypervisor 框架,无需额外配置 HAXM,但仍需确保 CPU 支持 VT-x。

5.2 调整 Android Studio 内存分配

默认情况下,Android Studio 可能会分配较少的内存。如果您的 RAM 充足,可以适当增加。

  1. 在 Android Studio 中,点击 File -> Settings (Windows/Linux) 或 Android Studio -> Preferences (macOS)。
  2. 导航到 Appearance & Behavior -> System Settings -> Memory Settings
  3. 调整“IDE maximum heap size”和“Daemon maximum heap size”等选项,例如分别设置为 2048MB 或 4096MB,具体取决于您的总内存。

5.3 代理设置 (如果您的网络需要代理)

  1. 在 Android Studio 欢迎界面,点击“Configure” -> “Settings”。
  2. 导航到 Appearance & Behavior -> System Settings -> HTTP Proxy
  3. 配置您的代理服务器信息。

5.4 常见问题与解决方案

5.4.1 “JAVA_HOME environment variable is not set.” 或 “No JDK found.”
  • 问题原因: JAVA_HOME 环境变量未正确设置,或指向的路径不正确。
  • 解决方案:
    • 仔细检查第二章中 JAVA_HOME 的配置步骤,确保路径无误。
    • 确认您打开的是 新的 命令行/终端窗口,以便环境变量生效。
    • 确认 JDK 版本与 Android Studio 兼容 (通常新版 Android Studio 支持 OpenJDK 11 或 17)。
    • 检查 JDK 路径下是否有 bin 目录,以及 bin 目录下是否有 java.exe (或 java 可执行文件)。
5.4.2 “SDK location not found.” 或 Gradle 同步失败提示 SDK 相关错误
  • 问题原因: Android Studio 未找到 SDK 目录,或 ANDROID_HOME 环境变量未正确设置。
  • 解决方案:
    • 在 Android Studio 中,通过 File -> Settings -> Android SDK 检查 SDK 路径是否正确。如果路径错误或为空,重新指定。
    • 检查第四章中 ANDROID_HOMEPath 环境变量的配置。
    • 确认 SDK 目录及其子目录 (platform-tools, tools, cmdline-tools) 存在且可访问。
    • 尝试在 Android Studio 的 SDK Manager 中重新下载或更新 SDK 组件。
5.4.3 模拟器无法启动或运行缓慢
  • 问题原因: 硬件虚拟化技术未启用,或驱动未正确安装。
  • 解决方案:
    • 检查 BIOS/UEFI 中是否启用了 Intel VT-x/AMD-V。
    • Windows 用户检查 HAXM (Intel) 或 Hyper-V (AMD) 是否正确安装和启用。
    • macOS 用户检查 CPU 是否支持 VT-x。
    • 确保分配给模拟器的内存和显存足够。
    • 尝试冷启动模拟器 (Wipe Data)。
5.4.4 Gradle 同步失败或编译错误
  • 问题原因: 网络问题、Gradle 缓存问题、项目依赖冲突、SDK 组件缺失。
  • 解决方案:
    • 检查网络连接,确保可以访问 Google 和 Maven 仓库。
    • 如果使用了代理,检查代理设置是否正确。
    • 在 Android Studio 菜单栏点击 File -> Invalidate Caches / Restart...,选择 Invalidate and Restart
    • 在 Gradle 视图中点击刷新按钮(同步项目)。
    • 检查 build.gradle 文件中的依赖版本。
    • 确保所有必要的 SDK 组件都已通过 SDK Manager 下载。
5.4.5 磁盘空间不足
  • 问题原因: Android SDK、模拟器系统镜像、Gradle 缓存等文件占用大量空间。
  • 解决方案:
    • 定期清理 Gradle 缓存 (File -> Invalidate Caches / Restart...,选择 Invalidate and Restart)。
    • 在 SDK Manager 中卸载不必要的 Android SDK 版本或系统镜像。
    • 清理旧项目和日志文件。

第六章:祝贺与下一步

恭喜您!通过以上详尽的步骤,您应该已经成功安装并配置了 Android Studio 及其开发环境。现在,您已经拥有了在 Windows、macOS 或 Linux 上开发 Android 应用程序的强大工具。

下一步:

  1. 创建您的第一个 Android 项目: 在 Android Studio 欢迎界面,点击“New Project”,选择一个模板,然后按照向导完成创建。
  2. 熟悉 Android Studio 界面: 探索其各种窗口、工具栏和快捷键。
  3. 学习 Kotlin 或 Java: 这是 Android 应用开发的核心语言。
  4. 阅读官方文档: Android 开发者官网 (developer.android.com) 是您最好的学习资源。

重要提示: Android Studio 和 Android SDK 会持续更新。建议您定期通过 Android Studio 内置的更新功能 (Help -> Check for Updates) 来获取最新版本,以获得更好的功能和性能。

祝您在 Android 开发的旅程中一切顺利,创造出令人惊叹的应用程序!

发表评论

您的邮箱地址不会被公开。 必填项已用 * 标注

滚动至顶部