qa-mobile-testing

SKILL.md

---
name: qa-mobile-testing
slug: qa-mobile-testing
displayName: Mobile Testing
version: 1.7.5
description: >-
  当需要测试 iOS/Android 原生 App、H5 页面或小程序的移动端专项场景时使用此技能。移动端的坑主要不在功能逻辑上——中断（电话/通知/低电量）、弱网/断网/网络切换、前后台切换、系统权限管理、多机型适配和各种系统版本兼容才是重灾区。不要只测功能流程，移动端的 Bug 有一半以上是中断和兼容性相关的。输出按中断/网络/权限/兼容/性能分类的测试要点清单。

when_to_use: 用户说"移动测试"、"App测试"、"Android测试"、"iOS测试"、"手机上测"、"H5测试"、"小程序测试"、"移动端中断测试"、"移动端兼容测试"、需要测试移动应用、移动端发版前全面测试时
allowed-tools: Read Grep Glob Bash
related_skills:
  upstream:
    - qa-test-automation-arch    # 输入：自动化架构设计
    - qa-specialized-testing     # 输入：专项测试方法
  downstream:
    - qa-ci-cd-testing           # 输出：移动端测试用于CI/CD
    - qa-release-risk-governance # 输出：测试结果用于发布评估
references:
  - references/platform-mini-program.md
  - references/platform-mobile-app.md
  - references/platform-mobile-web.md
  - references/platform-pc-web.md
input_format:
  required:
    - name: 测试策略
      type: object
      description: 来自qa-test-strategy-design的测试策略
    - name: 移动端需求
      type: string
      description: 移动端的特性需求和平台要求
  optional:
    - name: 设备清单
      type: array
      description: 测试设备和OS版本列表
output_format:
  traceability:
    - 每个移动端测试用例带唯一ID（TC_{模块缩写}_{功能缩写}_{序号}，如 TC_API_LOGIN_001）
    - 关联平台和需求ID
  structure:
    - 测试用例表格：固定 9 列（用例编号|测试类型|功能模块|测试标题|用例级别|预置条件|测试步骤|预期结果|风险等级）
    - 用例级别：P0≤20%（核心流程）/ P1≤40%（主要功能）/ P2≤30%（次要功能）/ P3≤10%（边缘场景）
    - 覆盖率：标注口径（基于现有需求/输入文档），禁止"全覆盖/100%"绝对化表述；缺失模块标注"未覆盖+原因"
    - mobile_test_plan: 移动端测试方案
    - device_coverage: 设备覆盖矩阵
    - platform_specific: 平台特性测试清单
    - performance_checks: 性能测试要点
error_recovery_guidance:
  on_failure: "设备兼容性问题时切换到备用设备或模拟器，记录环境信息"
  retry_behavior: "更换测试设备或修复环境问题后重新执行移动端测试"
categories: ['Development','Testing']
depth_requirement_quantification:
  reference_value: "根据平台复杂度调整测试深度：简单×1/中等×2/复杂×3"
  minimum: "至少覆盖中断、网络、权限、兼容4个移动端维度"
---
# 移动端测试专项

## 核心原则

移动测试的核心挑战——设备碎片化、网络不稳定性、用户场景多样性。

## 移动端测试深度要求（参考值）

| 复杂度 | 用例数要求 | 设备覆盖 |
|--------|-----------|---------|
| 简单App | 30条 | 2-3台主流设备 |
| 中等App | 50条 | 5-8台设备 |
| 复杂App | 80条 | 10+台设备+多系统版本 |

**必须覆盖的6个维度**：

| 维度 | 占比 | 说明 |
|------|------|------|
| 功能测试 | 35% | 核心功能、业务流程 |
| 兼容性测试 | 25% | 设备/系统/屏幕 |
| 中断测试 | 15% | 来电/短信/通知/切换 |
| 性能测试 | 10% | 启动/内存/电量/流量 |
| 弱网测试 | 10% | 网络切换/弱网/离线 |
| 安全测试 | 5% | 权限/数据保护 |

> **平台专项参考**：不同平台有各自的高风险场景，加载对应参考文件可获取专项测试要点：
> - [`references/platform-mobile-app.md`](references/platform-mobile-app.md) — iOS/Android 原生 App 专项
> - [`references/platform-mobile-web.md`](references/platform-mobile-web.md) — H5/移动 Web 专项
> - [`references/platform-mini-program.md`](references/platform-mini-program.md) — 小程序专项
>
> 桌面端 / PC Web 专项不属于本技能范围，如需测试桌面端或 PC Web 请使用通用测试策略技能。

## 移动端测试检查清单

### 功能测试检查
- [ ] 安装/卸载/升级正常
- [ ] 核心功能完整
- [ ] 中断测试通过
- [ ] 离线功能可用

### 兼容性测试检查
- [ ] 主流设备覆盖
- [ ] 系统版本覆盖
- [ ] 屏幕尺寸适配
- [ ] 横竖屏切换

### 中断测试检查
- [ ] 来电/短信中断
- [ ] 通知中断
- [ ] 低电量处理
- [ ] 网络切换
- [ ] 后台/前台切换

### 性能测试检查
- [ ] 启动时间达标
- [ ] 内存占用正常
- [ ] 帧率流畅
- [ ] 电量消耗合理

### 弱网测试检查
- [ ] WiFi/4G切换
- [ ] 弱网环境表现
- [ ] 离线状态处理
- [ ] 网络恢复后同步

### 功能测试

```text
测试范围：
├─ 安装/卸载/升级
│   ├─ 全新安装
│   ├─ 覆盖安装
│   ├─ 升级安装
│   ├─ 卸载重装
│   └─ 跨版本升级
│
├─ 核心功能
│   ├─ 业务流程测试
│   ├─ 功能交互测试
│   ├─ 数据持久化测试
│   └─ 离线功能测试
│
└─ 中断测试
    ├─ 来电/短信中断
    ├─ 通知中断
    ├─ 低电量中断
    ├─ 网络切换中断
    └─ 后台/前台切换
```

### 兼容性测试

```text
设备维度：
├─ 屏幕尺寸：小屏/标准/大屏/折叠屏
├─ 分辨率：720p/1080p/2K/4K
├─ 系统版本：iOS 14+/Android 8+
├─ 设备类型：手机/平板/折叠屏
└─ 品牌厂商：三星/华为/小米/OPPO

系统特性：
├─ 权限管理：不同权限策略
├─ 通知管理：不同通知行为
├─ 后台策略：不同后台限制
└─ 存储策略：不同存储权限
```

### 性能测试

```text
性能指标：
├─ 启动时间
│   ├─ 冷启动：<2秒
│   ├─ 热启动：<1秒
│   └─ 温启动：<1.5秒
│
├─ 内存使用
│   ├─ 内存占用：<200MB
│   ├─ 内存泄漏：无持续增长
│   └─ 内存峰值：<300MB
│
├─ 电量消耗
│   ├─ 待机耗电：<5%/天
│   ├─ 使用耗电：<15%/小时
│   └─ 后台耗电：<3%/小时
│
├─ 流量消耗
│   ├─ 首次加载：<5MB
│   ├─ 每次操作：<1MB
│   └─ 后台同步：<10MB/天
│
└─ 帧率
    ├─ 滑动帧率：>55fps
    ├─ 动画帧率：>55fps
    └─ 页面切换：>50fps
```

### 网络测试

```text
网络场景：
├─ 网络类型
│   ├─ WiFi
│   ├─ 4G/5G
│   ├─ 弱网（高延迟、低带宽）
│   └─ 断网
│
├─ 网络切换
│   ├─ WiFi → 4G
│   ├─ 4G → WiFi
│   ├─ 有网 → 断网
│   └─ 断网 → 有网
│
└─ 弱网模拟
    ├─ 高延迟：>500ms
    ├─ 低带宽：<100kbps
    ├─ 高丢包：>10%
    └─ 网络抖动：延迟不稳定
```

## 自动化测试

### 工具选型

```text
├─ Appium
│   ├─ 优点：跨平台、语言无关
│   ├─ 缺点：速度较慢、稳定性一般
│   └─ 适用：跨平台项目
│
├─ XCTest（iOS）
│   ├─ 优点：官方支持、性能好
│   ├─ 缺点：仅iOS
│   └─ 适用：iOS原生应用
│
├─ Espresso（Android）
│   ├─ 优点：官方支持、速度快
│   ├─ 缺点：仅Android
│   └─ 适用：Android原生应用
│
└─ Airtest
    ├─ 优点：图像识别、游戏测试
    ├─ 缺点：维护成本高
    └─ 适用：游戏、H5混合应用
```

### Page Object模式

```python
# 示例：Android Page Object
class LoginPage:
    def __init__(self, driver):
        self.driver = driver
    
    username_field = ResourceId("com.example:id/username")
    password_field = ResourceId("com.example:id/password")
    login_button = ResourceId("com.example:id/login")
    
    def login(self, username, password):
        self.driver.find_element(*self.username_field).send_keys(username)
        self.driver.find_element(*self.password_field).send_keys(password)
        self.driver.find_element(*self.login_button).click()
```

## 兼容性测试矩阵

```markdown
| 设备 | 系统版本 | 屏幕尺寸 | 测试状态 |
|------|---------|---------|---------|
| iPhone 14 | iOS 16 | 6.1寸 | ✅ 通过 |
| iPhone 12 | iOS 15 | 6.1寸 | ✅ 通过 |
| Samsung S23 | Android 13 | 6.1寸 | ✅ 通过 |
| Huawei Mate 50 | HarmonyOS 3 | 6.7寸 | ⚠️ 待测 |
| Xiaomi 13 | Android 13 | 6.36寸 | ✅ 通过 |
```

## 输出示例

**测试移动端登录功能**
→ 五维覆盖：
  - 功能：登录/登出/自动登录/多设备登录
  - 兼容性：iOS15/16/17 + Android 12/13/14 + 主流机型
  - 中断：来电/短信/通知/低电量/闹钟弹出
  - 性能：启动时间/页面加载/内存占用
  - 弱网：3G/弱WiFi/飞行模式/网络切换

**App首页加载慢（iOS 3秒，Android 5秒）**
→ 触发性能测试清单，检查首页接口、图片加载、缓存策略

## 检查清单

移动端测试完成后检查：
- [ ] 安装/卸载/升级是否测试？
- [ ] 核心功能是否覆盖？
- [ ] 中断场景是否测试？
- [ ] 兼容性矩阵是否覆盖？
- [ ] 性能指标是否达标？
- [ ] 网络场景是否测试？
- [ ] 自动化脚本是否可维护？