移动端测试（中文版）

英文版： 见技能 mobile-testing-en。

提示词见本目录 prompts/mobile-testing.md。

何时使用

• 用户提到「移动端测试」「mobile testing」「APP 测试」「iOS/Android 测试」
• 需要设计或执行移动端测试方案与用例（设备矩阵、系统版本、网络、生命周期等）
• 触发示例：「根据以下需求设计移动端测试方案」「输出移动端测试用例」

输出格式选项

默认 Markdown。若需 Excel / CSV / JSON，请在需求末尾说明，详见 output-formats.md。

如何使用

1. 打开本目录 prompts/ 下对应提示词文件，复制虚线以下内容。
2. 附加你的需求与上下文（业务流程、环境、约束、验收标准）。
3. 若需非 Markdown 输出，在末尾追加 output-formats.md 中的请求句。

代码示例

1. Appium Android 自动化测试

完整的 Appium + Python Android 测试示例。

位置： examples/appium-android/

包含内容：

• Page Object Model 架构
• 登录和导航测试
• 手势操作示例
• Pytest 配置

快速开始：

cd examples/appium-android
pip install -r requirements.txt
appium &
pytest

详见：examples/appium-android/README.md

最佳实践

移动测试策略

1. 设备覆盖

   • 主流设备型号
   • 不同屏幕尺寸
   • 不同系统版本

2. 测试类型

   • 功能测试
   • 兼容性测试
   • 性能测试
   • 网络测试
   • 安全测试

3. 自动化策略

   • 核心流程自动化
   • 回归测试自动化
   • 手工测试补充

常见误区 | Common Pitfalls

• ❌ 只在单一机型上验证 → ✅ 覆盖关键机型/系统版本/网络组合矩阵
• ❌ 忽略生命周期中断场景 → ✅ 覆盖来电、切后台、权限弹窗等干扰流程
• ❌ 不测试弱网与离线场景 → ✅ 验证弱网、抖动、断网下的容错行为
• ❌ 只关注页面流程 → ✅ 同时覆盖安装升级、崩溃、耗电与性能指标

故障排除

常见问题

1. Appium 连接失败

解决方案:

appium --version
adb devices
pkill -f appium && appium

2. 元素定位失败

解决方案:

• 使用 Appium Inspector
• 增加等待时间
• 检查定位器

3. 应用安装失败

解决方案:

adb install app.apk
adb uninstall com.example.app

参考文件

• prompts/mobile-testing.md — 移动端测试 Standard-version 提示词
• output-formats.md — Markdown / Excel / CSV / JSON 请求说明
• examples/appium-android/ — Appium Android 完整示例
• quick-start.md — 5 分钟快速上手指南

目标受众

• 在真实项目中执行该测试域工作的 QA 与开发人员
• 需要结构化、可复用测试交付物的测试负责人
• 需要快速生成可落地测试产出的 AI 使用者

不适用场景

• 无测试范围上下文的纯线上应急处置
• 需要法律/合规最终裁定但缺少专家复核的决策
• 缺少最小输入（范围、环境、期望行为）的请求

关键成功因素

• 先明确范围、环境与验收标准，再生成测试内容
• 生成结果必须结合真实系统约束做二次校验
• 保持产物可追踪（需求 -> 测试点 -> 缺陷 -> 决策）

输出模板与解析脚本

• 模板目录：output-templates/
  • template-word.md（Word 友好结构）
  • template-excel.tsv（Excel 可直接粘贴）
  • template-xmind.md（XMind 结构化大纲）
  • template-json.json
  • template-csv.csv
  • template-markdown.md
• 解析脚本目录：scripts/
  • 解析通用：parse_output_formats.py
  • 解析按格式：parse_word.py、parse_excel.py、parse_xmind.py、parse_json.py、parse_csv.py、parse_markdown.py
  • 转换通用：convert_output_formats.py
  • 转换按格式：convert_to_word.py、convert_to_excel.py、convert_to_xmind.py、convert_to_json.py、convert_to_csv.py、convert_to_markdown.py
  • 批量转换：batch_convert_templates.py（批量输出到 artifacts/）

示例：

python3 scripts/parse_json.py output-templates/template-json.json
python3 scripts/parse_markdown.py output-templates/template-markdown.md
python3 scripts/convert_to_json.py output-templates/template-markdown.md
python3 scripts/convert_output_formats.py output-templates/template-json.json --to csv
python3 scripts/batch_convert_templates.py --skip-same