feat: add Android and iOS tester skills

This commit is contained in:
2026-10-11 17:29:04 +08:00
parent cf78d0cab2
commit 1100eec884
13 changed files with 557 additions and 0 deletions
@@ -0,0 +1,95 @@
# 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)。