96 lines
3.0 KiB
Markdown
96 lines
3.0 KiB
Markdown
# 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)。
|