用例模板规范
适用场景
本模板适用于所有CameraX 权限请求回归用例的设计与编写，覆盖 Android 6.0 及以上运行时权限、相机权限申请、用户授权/拒绝、权限撤销、跨应用权限继承等测试场景。当测试团队需要统一用例结构、便于评审与自动化转换时，必须使用本规范定义的用例模板。
前置条件
- 已获取被测应用的授权需求文档（PRD/功能规格），明确 CameraX 版本、最小 SDK 版本、targetSdkVersion。
- 已搭建或确认可用的测试环境（真机/模拟器，至少覆盖 Android 6.0、8.0、10.0、12.0 四个版本）。
- 测试用例管理工具（如 TestRail、Xray、禅道）已配置，且字段映射与本模板一致。
- 测试工程师已阅读《CameraX 权限请求回归测试策略》文档，了解风险点与回归范围。
操作步骤
按照以下顺序填写用例模板的每个字段，不可跳过或合并步骤：
- 确定用例编号 —— 遵循“模块-权限-序号”规则（详见下方表格）。
- 填写前置条件 —— 列出执行该用例前必须满足的测试环境、应用状态、权限状态。
- 书写测试步骤 —— 使用“操作+期望”分段，每步以动词开头，不可包含主观判断。
- 定义预期结果 —— 明确系统反应（弹窗、回调、日志、UI 变化），避免模糊描述。
- 预留实际结果与备注 —— 执行时记录，备注字段用于说明变体、缺陷链接或跳过原因。
- 自检与提交 —— 使用下方验收标准逐项检查，通过后进入评审队列。
输入输出物
| 类型 | 输入物 | 输出物 |
|---|---|---|
| 文档 | 《CameraX 权限需求清单》 《测试策略 V2.1》 |
《CameraX 权限请求回归用例》V1.0（Excel/TSV 格式） |
| 工具 | 用例模板文件（.xlsx） | 已填写的用例集合（含评审批注） |
| 责任方 | 测试工程师 | 测试组长（评审确认） |
责任边界
- 测试工程师：负责填写所有字段，确保编号唯一、步骤可执行、预期结果可验证。
- 测试组长：负责审查模板格式、编号规则、前置条件完整性，每周五前完成评审。
- 开发人员：仅在缺陷定位阶段提供备注信息，不参与模板填写。
- 配置管理员：维护用例模板的版本及字段变更记录。
记录材料
- 用例模板文件（含字段说明页）
- 评审会议纪要（包含否决项与修改意见）
- 用例执行日志（关联 JIRA/缺陷编号）
- 变更历史表：每次模板更新需记录日期、修改人、修改原因
异常处理
| 异常场景 | 处理方式 |
|---|---|
| 用例编号冲突（与已归档用例重复） | 在原有编号后加字母后缀（如 -A、-B），并在备注中注明冲突原因 |
| 前置条件无法满足（如缺特定系统版本设备） | 标记为“阻塞”，填写替代方案或降级设备，备注截至日期 |
| 测试步骤步骤数 > 15 | 拆分用例为多个子用例，编号使用 .1、.2 子序号 |
| 预期结果包含非确定性描述（如“可能弹窗”） | 要求测试工程师重新确认需求文档或咨询产品，改写为确定性描述 |
验收标准
- 每个用例的编号符合 CAM-PERM-UT-XXX 三段式规则（CAM 表示 CameraX，PERM 表示权限，UT 表示单元/回归，XXX 为三位递增数字）。
- 前置条件至少包含：Android 版本、应用包名、初始权限状态（已授权/未授权/未知）。
- 测试步骤指令清晰，不包含“如果”“否则”“可能”等分支词汇；分支场景须另写用例。
- 预期结果必须明确系统级行为（如 “系统弹出权限请求对话框”）或应用级行为（如 “预览画面显示”）。
- 实际结果字段留空或标记为 “待执行”；备注字段可为空，但若填写则须使用标准标签 [缺陷ID]、[跳过原因]、[环境备注]。
- 所有字段均不为空（备注除外），且字段内容不超过 500 字符。
关键提示：实际结果与预期结果不一致时，立即在备注中记录差异，并截图保存日志。不可私下修改预期结果来匹配实际行为，必须走缺陷流程。
最佳实践：建议在用例编写工具中为“前置条件”“测试步骤”“预期结果”三个字段设置必填校验，并在提交时自动检查编号格式。
用例字段设计总览（SVG 结构图）
注意：版本迭代中若字段结构发生变化（如新增“测试数据”列），必须同步更新本模板的编号规则和验收标准，并通知所有测试工程师。