核心环境搭建 (基石准备)
-
更新系统与安装基础工具

sudo apt update && sudo apt upgrade -y sudo apt install -y git curl wget unzip zip make gcc libc6-dev
-
安装 Java Development Kit (JDK)
- 推荐选择:OpenJDK 17 (LTS) (安卓 Gradle 插件兼容性最佳)
sudo apt install -y openjdk-17-jdk
- 验证安装:
java -version javac -version
- 推荐选择:OpenJDK 17 (LTS) (安卓 Gradle 插件兼容性最佳)
-
安装 Android Studio (官方IDE)
- 官方下载:访问 Android Developer官网 获取最新Linux版本
.tar.gz包。 - 解压安装:
tar -xzvf ~/Downloads/android-studio-.tar.gz -C ~
- 启动与初始化:
cd ~/android-studio/bin ./studio.sh
- 首次运行:跟随向导完成SDK组件下载(Android SDK Build-Tools, Platform Tools, 最新Android Platform SDK 必选)。强烈建议勾选
Android Virtual Device (AVD)用于后续模拟器创建。
- 官方下载:访问 Android Developer官网 获取最新Linux版本
-
配置关键环境变量
- 编辑
~/.bashrc(或~/.zshrc):export ANDROID_HOME=$HOME/Android/Sdk export PATH=$PATH:$ANDROID_HOME/cmdline-tools/latest/bin export PATH=$PATH:$ANDROID_HOME/platform-tools export PATH=$PATH:$ANDROID_HOME/emulator
- 使配置生效:
source ~/.bashrc # 或 source ~/.zshrc
- 验证ADB/Fastboot:
adb --version fastboot --version
- 编辑
安卓虚拟设备 (AVD) 配置与优化 (高效模拟)
-
启用KVM硬件加速 (性能关键!)
- 检查CPU是否支持虚拟化:
egrep -c '(vmx|svm)' /proc/cpuinfo # 输出 > 0 即支持
- 安装KVM:
sudo apt install -y qemu-kvm libvirt-daemon-system libvirt-clients bridge-utils virt-manager sudo adduser $USER kvm sudo adduser $USER libvirt
- 重启系统使权限生效。
- 在Android Studio AVD Manager创建AVD时,务必选择
x86_64或x86系统镜像,运行时将自动启用硬件加速,速度提升显著。
- 检查CPU是否支持虚拟化:
-
创建高性能AVD
- 在Android Studio中打开
AVD Manager。 - 选择硬件配置 (如
Pixel 6),下载推荐的x86_64Android版本镜像。 - 在
Graphics设置中,优先选择Hardware - GLES 2.0(性能最佳),若遇兼容性问题可尝试Software。
- 在Android Studio中打开
连接真机调试 (真实环境测试)
-
启用USB调试

- 手机进入
开发者选项(多次点击设置->关于手机->版本号)。 - 开启
USB调试和USB安装。
- 手机进入
-
Ubuntu端配置USB权限
- 创建
51-android.rules文件:sudo nano /etc/udev/rules.d/51-android.rules
- 添加规则 (替换
<username>为你的用户名):SUBSYSTEM=="usb", ATTR{idVendor}=="18d1", MODE="0666", GROUP="plugdev", OWNER="<username>" SUBSYSTEM=="usb", ATTR{idVendor}=="XXXX", MODE="0666", GROUP="plugdev", OWNER="<username>" # 其他厂商ID - 常用厂商ID:Google=
18d1, Samsung=04e8, HTC=0bb4, Sony=054c, Motorola=22b8,可通过lsusb命令查看连接设备的ID。 - 重载规则并重启服务:
sudo udevadm control --reload-rules sudo service udev restart sudo usermod -aG plugdev $USER # 确保用户加入plugdev组
- 重启Ubuntu 确保所有变更生效。
- 创建
-
连接与授权
- 用USB线连接手机和电脑。
- 手机弹出
允许USB调试吗?提示时,勾选始终允许并确认。 - 终端运行
adb devices,应看到设备序列号并显示device。
实战:创建并运行首个应用
-
在Android Studio中:
File->New->New Project。- 选择模板 (如
Empty Views Activity)。 - 配置项目名称、包名、保存路径、语言 (Kotlin推荐)、最低API级别。
- 点击
Finish,等待Gradle完成初始构建。
-
选择运行目标:
- 工具栏下拉菜单中,选择已配置好的AVD或连接的物理设备。
- 点击绿色
Run三角按钮 (或按Shift+F10)。 - Android Studio会自动编译APK,安装到目标设备并启动应用。
高级技巧与避坑指南 (专业解决方案)
-
Gradle构建加速:
- 在
~/.gradle/gradle.properties中添加:org.gradle.daemon=true org.gradle.parallel=true org.gradle.caching=true android.useAndroidX=true kapt.incremental.apt=true
- 考虑使用 Gradle Build Scan 分析构建瓶颈。
- 在
-
ADB常见问题:

- 设备未识别:确认
adb devices无输出。- 检查USB线/端口,尝试不同端口。
- 重启
adb server:adb kill-server && adb start-server。 - 确认
lsusb能看到设备,且51-android.rules配置正确且生效。
- INSTALL_FAILED_UPDATE_INCOMPATIBLE:设备上已存在相同包名但签名不同的应用,卸载旧版本即可。
- 设备未识别:确认
-
Linux文件句柄限制:
大规模项目或模拟器多开时可能遇到Too many open files错误。# 临时提高限制 ulimit -n 65536 # 永久修改 (谨慎操作,了解风险) sudo nano /etc/security/limits.conf # 添加行: soft nofile 65536 hard nofile 65536
需重启生效。
-
替代模拟器选择:
对于资源消耗敏感或需要更低层级控制的场景,可考虑 Waydroid 基于容器技术的轻量级安卓兼容层,直接在Linux桌面运行安卓应用。
你更倾向于使用安卓模拟器还是真机进行日常开发?在实际使用中,是否遇到过Ubuntu环境下特有的调试难题(如USB连接稳定性、特定硬件兼容性问题)?欢迎在评论区分享你的实战经验和高效技巧!
原创文章,作者:世雄 - 原生数据库架构专家,如若转载,请注明出处:https://idctop.com/article/27786.html