# 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`，必须满足：

```bash
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 主机依赖

在用户确认后安装：

```bash
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"
```

检查：

```bash
kvm-ok
ls -l /dev/kvm
```

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

## 3. 安装 Android SDK 工具

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

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

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

```bash
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。创建后运行：

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

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

## 5. 安装完成报告

报告必须包含：

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

安装 Android Studio 不是本模式的必要条件；该流程安装的是可由命令行运行的 Emulator
工具链。参考：[Android 安装文档](https://developer.android.com/studio/install)、
[KVM 加速文档](https://developer.android.com/studio/run/emulator-acceleration)。