Debian 安装 Android 模拟器

只支持 Debian amd64/x86_64。不要在 Ubuntu、其他发行版、ARM 主机或嵌套虚拟机中执行本流程。Android 官方 Linux 模拟器依赖 KVM；Android SDK Command-line Tools 提供 sdkmanager，Emulator 和 Platform-Tools 作为 SDK 包安装。

1. 检查并确认变更

读取 /etc/os-release，必须满足：

test "$(. /etc/os-release && printf '%s' "$ID")" = debian
test "$(dpkg --print-architecture)" = amd64

安装前向用户展示：

将通过 apt 安装的 Debian 包。
Android SDK 目录，默认 ~/Android/Sdk。
要下载的 Emulator、Platform-Tools、Command-line Tools 和 system image。
会把当前用户加入 kvm、libvirt 组，通常需要重新登录。
是否创建 AVD，以及 AVD 名称、API、镜像和设备 profile。

没有明确安装请求或用户未确认这些变更时，只输出检查结果，不执行 sudo、apt 或下载。

2. 安装 Debian 主机依赖

在用户确认后安装：

sudo apt update
sudo apt install cpu-checker qemu-kvm libvirt-daemon-system \
  libvirt-clients bridge-utils curl ca-certificates unzip
sudo usermod -aG kvm,libvirt "$USER"

检查：

kvm-ok
ls -l /dev/kvm

若没有硬件虚拟化或 /dev/kvm，停止并报告安装失败。不要降级为极慢的软件模拟。

3. 安装 Android SDK 工具

优先使用 Android 官方 Linux Command-line Tools。若机器已有 sdkmanager，复用现有 SDK 根目录；否则从 Android 官方下载页获取 Linux Command-line Tools，解压为：

~/Android/Sdk/cmdline-tools/latest/

安装并接受 SDK 许可后，执行：

sdkmanager --install \
  "platform-tools" \
  "emulator" \
  "cmdline-tools;latest"

系统镜像由项目的 compile/target SDK 和用户明确选择的 API 决定。安装前先用 sdkmanager --list 查找可用的 google_apis;x86_64 镜像，不猜一个不可用的版本。

4. 创建 AVD

只有用户明确要求创建 AVD 时执行。优先使用当前 SDK 提供的 Android CLI；兼容环境可使用 avdmanager 创建一个明确命名、明确 API 和明确 x86_64 镜像的 AVD。创建后运行：

emulator -list-avds
emulator -accel-check
emulator @<已确认的AVD名称>

<已确认的AVD名称> 只表示用户已经选择的实际名称，不允许由 skill 静默猜测。

5. 安装完成报告

报告必须包含：

Debian 版本和架构。
apt 安装包及结果。
SDK 根目录和工具版本。
已安装的 system image。
AVD 名称和配置。
KVM 检查结果。
是否需要重新登录。
下一步是运行模拟器检查，还是直接执行测试。

安装 Android Studio 不是本模式的必要条件；该流程安装的是可由命令行运行的 Emulator 工具链。参考：Android 安装文档、 KVM 加速文档。

3.0 KiB Raw Blame History Unescape Escape