Android Studio 安装指南(Ubuntu 22.04)
本文档详细记录了在 Ubuntu 22.04 系统上安装 Android Studio 的完整过程,适合初学者参考。
📋 目录
系统要求
在开始安装之前,请确保你的系统满足以下要求:
| 项目 | 要求 |
|---|---|
| 操作系统 | Ubuntu 22.04 LTS 或更高版本 |
| 内存 | 至少 8GB RAM(推荐 16GB) |
| 磁盘空间 | 至少 15GB 可用空间 |
| Java 版本 | OpenJDK 17 或更高版本 |
| 网络 | 稳定的互联网连接(用于下载组件) |
安装步骤
步骤 1:安装依赖包
首先需要安装一些基础工具和 Java 环境。
bash
# 更新软件包列表
sudo apt update
# 安装必要的工具和 Java 17
sudo apt install -y wget unzip openjdk-17-jdk
说明:
wget:用于下载文件unzip:用于解压文件openjdk-17-jdk:Android Studio 需要的 Java 开发工具包
步骤 2:下载 Android Studio
下载最新版本的 Android Studio 安装包(约 1.2GB)。
bash
# 进入临时目录
cd /tmp
# 下载 Android Studio
wget https://redirector.gvt1.com/edgedl/android/studio/ide-zips/2024.1.1.12/android-studio-2024.1.1.12-linux.tar.gz
下载说明:
- 文件大小:约 1.2GB
- 下载时间:取决于网络速度(通常 5-15 分钟)
- 文件名:
android-studio-2024.1.1.12-linux.tar.gz
步骤 3:解压并安装
将 Android Studio 解压到系统目录 /opt/。
bash
# 解压到 /opt 目录
sudo tar -xzf /tmp/android-studio-2024.1.1.12-linux.tar.gz -C /opt/
安装位置说明:
- 主程序目录:
/opt/android-studio/ - 可执行文件:
/opt/android-studio/bin/studio.sh
步骤 4:创建全局命令
创建符号链接,让你可以在任何位置使用 android-studio 命令。
bash
# 创建符号链接
sudo ln -s /opt/android-studio/bin/studio.sh /usr/local/bin/android-studio
这样做的好处:
- 无需每次都输入完整路径
- 可以在终端任何位置启动 Android Studio
验证安装
检查安装是否成功
bash
# 检查 Java 版本
java -version
# 检查 Android Studio 命令
which android-studio
# 查看安装目录
ls -la /opt/android-studio/
预期输出:
# java -version
openjdk version "17.0.x" ...
# which android-studio
/usr/local/bin/android-studio
# ls -la /opt/android-studio/
drwxrwxr-x 7 root root 4096 ...
drwxrwxr-x 4 root root 4096 bin
drwxrwxr-x 6 root root 4096 jbr
drwxrwxr-x 6 root root 4096 lib
...
启动 Android Studio
方法 1:使用全局命令(推荐)
bash
android-studio
方法 2:使用完整路径
bash
/opt/android-studio/bin/studio.sh
方法 3:从应用菜单(如果已创建)
某些系统可能会在应用菜单中创建快捷方式。
首次启动配置
Android Studio 首次启动时会引导你完成初始设置:
1. 欢迎界面
- 点击 "Next" 继续
2. 安装类型选择
-
推荐选择 :
Standard(标准模式)- 自动下载 Android SDK
- 自动配置常用组件
- 适合大多数用户
-
高级选项 :
Custom(自定义模式)- 可以手动选择组件
- 自定义 SDK 位置
- 适合有特殊需求的用户
3. SDK 位置
- 默认位置:
~/Android/Sdk/ - 可以自定义,但建议使用默认位置
4. 组件下载
Android Studio 会自动下载以下组件:
- Android SDK Platform
- Android SDK Build-Tools
- Android SDK Command-line Tools
- Android Emulator(模拟器)
- Android SDK Platform-Tools
注意: 这个过程可能需要 10-30 分钟,取决于网络速度。
5. 完成设置
- 点击 "Finish" 完成配置
- Android Studio 会启动主界面
常见问题
Q1: 启动时提示 "Unable to access Android SDK"
解决方案:
bash
# 检查 SDK 目录是否存在
ls -la ~/Android/Sdk/
# 如果不存在,手动创建
mkdir -p ~/Android/Sdk/
Q2: 启动时卡在 "Loading Components"
解决方案:
- 检查网络连接
- 等待一段时间(首次启动较慢)
- 如果长时间无响应,可以重启 Android Studio
Q3: 提示 "Java not found"
解决方案:
bash
# 确认 Java 已安装
java -version
# 如果未安装,重新安装
sudo apt install -y openjdk-17-jdk
Q4: 内存不足错误
解决方案:
- 关闭其他应用程序释放内存
- 增加交换空间(swap)
- 在 Android Studio 中调整内存设置:
Help→Edit Custom VM Options- 修改
-Xmx参数(例如:-Xmx4096m表示 4GB)
Q5: 图形界面无法启动
解决方案:
bash
# 检查显示服务器
echo $XDG_SESSION_TYPE
# 如果是 Wayland,尝试切换到 X11
# 或者使用 X11 转发
export DISPLAY=:0
卸载方法
如果需要卸载 Android Studio,可以按以下步骤操作:
1. 删除主程序目录
bash
sudo rm -rf /opt/android-studio/
2. 删除符号链接
bash
sudo rm /usr/local/bin/android-studio
3. 删除下载的安装包
bash
rm /tmp/android-studio-*.tar.gz
4. 删除 SDK 目录(可选)
bash
# 注意:这会删除所有已下载的 SDK 组件
rm -rf ~/Android/Sdk/
5. 删除配置文件(可选)
bash
# 删除 Android Studio 配置
rm -rf ~/.android/
rm -rf ~/.config/Google/AndroidStudio*
rm -rf ~/.local/share/Google/AndroidStudio*
常用命令速查
| 命令 | 说明 |
|---|---|
android-studio |
启动 Android Studio |
java -version |
检查 Java 版本 |
which android-studio |
查看命令位置 |
ls -la /opt/android-studio/ |
查看安装目录 |
sudo apt update |
更新软件包列表 |
sudo apt install <package> |
安装软件包 |
后续步骤
安装完成后,你可以:
-
创建第一个项目
- 点击 "New Project"
- 选择模板(Empty Activity)
- 配置项目名称和包名
-
配置 Android SDK
Tools→SDK Manager- 下载需要的 API 版本
- 配置模拟器
-
安装插件
File→Settings→Plugins- 搜索并安装常用插件(如:Kotlin、Flutter 等)
-
学习 Android 开发
- 官方文档:developer.android.com
- 在线课程:Udacity、Coursera
- 社区:Stack Overflow、GitHub
技术支持
如果遇到问题,可以参考以下资源:
- 官方文档:https://developer.android.com/studio
- 社区论坛:https://stackoverflow.com/questions/tagged/android-studio
- GitHub Issues:https://github.com/android/studio/issues
更新日志
2024年3月6日
- 初始版本
- 基于 Android Studio 2024.1.1.12
- 适用于 Ubuntu 22.04 LTS
祝你 Android 开发之旅愉快! 🚀