feat: add Android and iOS tester skills
This commit is contained in:
@@ -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)。
|
||||
Reference in New Issue
Block a user