Ubuntu 20.04 安装 Android Studio 详细指南

本文档详细介绍在 Ubuntu 20.04 虚拟机中安装 Android Studio 的完整流程。

系统要求

硬件要求

组件	最低要求	推荐配置
CPU	x86_64 架构，支持 VT-x/AMD-V	4 核心以上
内存	4GB	8GB 以上
硬盘	4GB 可用空间	20GB 以上 SSD
网络	稳定的互联网连接	-

软件要求

Ubuntu 20.04 LTS 或更高版本
sudo 权限

准备工作

1. 更新系统

打开终端，执行以下命令：

bash 复制代码

sudo apt update
sudo apt upgrade -y

2. 安装必要的依赖

bash 复制代码

# 安装基础工具
sudo apt install -y wget curl unzip git

# 安装 32 位库（Android 模拟器需要）
sudo apt install -y libc6:i386 libncurses5:i386 libstdc++6:i386 lib32z1 libbz2-1.0:i386

# 安装 Java 运行环境依赖
sudo apt install -y openjdk-11-jre

安装 JDK

Android Studio 需要 JDK（Java Development Kit）。推荐使用 JDK 17（Android Studio Hedgehog 及更高版本）或 JDK 11（较旧版本）。

方式一：使用 OpenJDK（推荐）

bash 复制代码

# 安装 JDK 17
sudo apt install -y openjdk-17-jdk

# 或安装 JDK 11
# sudo apt install -y openjdk-11-jdk

验证安装

bash 复制代码

java -version
javac -version

预期输出：

复制代码

openjdk version "17.0.x" 202x-xx-xx
OpenJDK Runtime Environment (...)
OpenJDK 64-Bit Server VM (...)

下载 Android Studio

官方下载地址

bash 复制代码

# 下载最新版本
wget https://redirector.gvt1.com/edgedl/android/studio/ide-zips/2024.1.1.12/linux/android-studio-2024.1.1.12-linux.tar.gz

# 如果链接失效，请访问官网获取最新下载链接：
# https://developer.android.com/studio#linux

使用浏览器下载（可选）

如果网络连接有问题，可以在浏览器中访问：

复制代码

https://developer.android.com/studio#downloads

下载 Linux 版本的 .tar.gz 文件。

安装 Android Studio

1. 解压文件

bash 复制代码

# 进入下载目录（通常在 ~/Downloads）
cd ~/Downloads

# 解压到 /opt 目录（推荐）
sudo tar -xzf android-studio-*.tar.gz -C /opt/

# 或者解压到用户目录（无需 sudo）
tar -xzf android-studio-*.tar.gz -C ~/

解压后会在 /opt/android-studio 或 ~/android-studio 创建安装目录。

2. 创建桌面快捷方式

bash 复制代码

# 创建桌面入口文件
sudo nano /usr/share/applications/android-studio.desktop

添加以下内容：

ini 复制代码

[Desktop Entry]
Version=1.0
Type=Application
Name=Android Studio
Comment=Android Development IDE
Exec=/opt/android-studio/bin/studio.sh
Icon=/opt/android-studio/bin/studio.png
Terminal=false
StartupNotify=true
Categories=Development;IDE;

保存并退出（Ctrl+X，然后 Y，然后 Enter）。

3. 添加到应用程序菜单

bash 复制代码

# 复制桌面文件
sudo cp /usr/share/applications/android-studio.desktop ~/Desktop/

# 赋予执行权限
chmod +x ~/Desktop/android-studio.desktop

首次启动配置

1. 启动 Android Studio

bash 复制代码

# 命令行启动
/opt/android-studio/bin/studio.sh

# 或者从应用程序菜单启动

2. 初始化向导

首次启动会看到安装向导：

步骤 1: 欢迎

选择 "Do not import settings"（首次安装）
点击 Next

步骤 2: 安装类型

选择 "Standard"（标准安装，推荐新手）
点击 Next

步骤 3: SDK 组件安装

向导会自动下载以下组件：

Android SDK：Android 开发工具包
Android SDK Platform-Tools：包含 adb、fastboot 等工具
Android Virtual Device：模拟器

等待下载完成（可能需要较长时间）。

步骤 4: 完成

点击 Finish 完成安装

配置环境变量

1. 找到 SDK 路径

默认 SDK 安装位置：

复制代码

~/Android/Sdk

2. 编辑环境变量

bash 复制代码

# 使用 nano 编辑器
nano ~/.bashrc

在文件末尾添加以下内容：

bash 复制代码

# Android SDK 环境变量
export ANDROID_HOME=$HOME/Android/Sdk
export ANDROID_SDK_ROOT=$HOME/Android/Sdk
export PATH=$PATH:$ANDROID_HOME/emulator
export PATH=$PATH:$ANDROID_HOME/tools
export PATH=$PATH:$ANDROID_HOME/tools/bin
export PATH=$PATH:$ANDROID_HOME/platform-tools
export PATH=$PATH:$ANDROID_HOME/build-tools/34.0.0

3. 使环境变量生效

bash 复制代码

source ~/.bashrc

4. 验证配置

bash 复制代码

# 验证 adb 命令
adb version

# 预期输出
# Android Debug Bridge version x.x.x

安装 Android SDK

如果选择自定义安装，需要手动安装 SDK 组件。

1. 打开 SDK Manager

在 Android Studio 中：

Tools → SDK Manager

2. 安装必要的 SDK 平台

推荐安装：

选项	说明
Android 14.0 (API 34)	最新稳定版本
Android 13.0 (API 33)	广泛支持
Android 12.0 (API 31)	较新设备

3. 安装 SDK 工具

确保勾选：

✅ Android SDK Build-Tools
✅ Android SDK Platform-Tools
✅ Android Emulator
✅ Android SDK Tools

配置虚拟机加速

检查 CPU 虚拟化支持

bash 复制代码

# 检查是否支持 VT-x/AMD-V
egrep -c '(vmx|svm)' /proc/cpuinfo

# 输出大于 0 表示支持虚拟化

安装 KVM（Kernel-based Virtual Machine）

bash 复制代码

# 检查是否支持 KVM
kvm-ok

# 如果提示 KVM 加速可用，安装相关包
sudo apt install -y cpu-checker

配置 HAXM（可选）

对于 Intel 处理器：

bash 复制代码

# 下载 HAXM
wget https://github.com/intel/haxm/releases/download/v7.6.5/haxm-v7.6.5-linux.zip

# 解压并安装
unzip haxm-v7.6.5-linux.zip
cd haxm-v7.6.5-linux
sudo ./install.sh

创建和运行 Android 模拟器

1. 打开 AVD Manager

在 Android Studio 中：

Tools → Device Manager → Create Device

2. 选择设备

选择一个设备定义，如 Pixel 6 ，点击 Next。

3. 选择系统镜像

选择并下载一个系统镜像：

推荐：API 34 (Android 14) 或 API 33 (Android 13)

4. 配置 AVD

给 AVD 命名
选择启动方向
点击 Finish

5. 启动模拟器

点击设备列表中的 播放按钮 启动模拟器。

常见问题解决

问题 1: 启动时报错 "Tools.jar not found"

解决方案：

bash 复制代码

# 设置 JAVA_HOME 环境变量
nano ~/.bashrc

# 添加
export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64

# 保存并生效
source ~/.bashrC

问题 2: 模拟器启动缓慢或无法启动

解决方案：

bash 复制代码

# 安装 KVM
sudo apt install -y qemu-kvm libvirt-daemon-system libvirt-clients bridge-utils

# 将用户添加到 kvm 组
sudo usermod -aG kvm $USER

# 重新登录生效

问题 3: Gradle 下载速度慢

解决方案：

配置国内镜像源，编辑 ~/.gradle/init.gradle：

groovy 复制代码

allprojects {
    repositories {
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/public' }
        maven { url 'https://maven.aliyun.com/repository/jcenter' }
        google()
        mavenCentral()
    }
}

问题 4: 无法检测到 Android 设备

解决方案：

bash 复制代码

# 创建 udev 规则
sudo nano /etc/udev/rules.d/51-android.rules

# 添加以下内容
SUBSYSTEM=="usb", ATTR{idVendor}=="0bbb", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb", ATTR{idVendor}=="0e79", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb", ATTR{idVendor}=="0502", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb", ATTR{idVendor}=="0b05", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb", ATTR{idVendor}=="413c", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb", ATTR{idVendor}=="0489", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb", ATTR{idVendor}=="091e", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb", ATTR{idVendor}=="18d1", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb", ATTR{idVendor}=="0fce", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb", ATTR{idVendor}=="19d2", MODE="0666", GROUP="plugdev"

# 重新加载 udev 规则
sudo udevadm control --reload-rules
sudo service udev restart

# 重新连接设备

问题 5: Android Studio 启动失败

解决方案：

bash 复制代码

# 删除配置文件夹重置
rm -rf ~/.AndroidStudio*
rm -rf ~/.android
rm -rf ~/.gradle

# 重新启动 Android Studio

问题 6: 内存不足

解决方案：

编辑 studio.vmoptions：

bash 复制代码

# 创建或编辑配置文件
nano ~/.AndroidStudio*/studio.vmoptions

# 调整内存设置
-Xms128m
-Xmx2048m
-XX:MaxPermSize=512m
-XX:ReservedCodeCacheSize=512m

卸载 Android Studio

如果需要完全卸载：

bash 复制代码

# 1. 删除安装目录
sudo rm -rf /opt/android-studio
rm -rf ~/android-studio

# 2. 删除配置文件
rm -rf ~/.AndroidStudio*
rm -rf ~/.android
rm -rf ~/.gradle

# 3. 删除桌面快捷方式
rm ~/Desktop/android-studio.desktop
sudo rm /usr/share/applications/android-studio.desktop

# 4. 删除项目目录（可选）
rm -rf ~/AndroidProjects

参考资料

版本信息

文档版本: 1.0
最后更新: 2026-05-12
适用于: Ubuntu 20.04 LTS / Android Studio 2024.1.1+

提示：在虚拟机中运行 Android Studio 和模拟器时，建议分配至少 4GB 内存给虚拟机以获得流畅体验。