游戏引擎 / 系统课时
平台差异测试怎样覆盖
平台差异测试怎样覆盖
多平台项目最容易漏测的不是主场景能否打开,而是授权被拒、存储重启、切后台和渠道分享等边缘路径。本课用“能力 × 运行平台 × 场景”的矩阵组织验证,再用脚本检查测试记录缺口,避免为每个平台复制一份笼统的测试清单。
学习目标
- 按能力拆分平台验证用例并标记适用性。
- 为登录、存储、生命周期和分发能力定义可观察的通过条件。
- 使用脚本检查矩阵覆盖缺口,并区分模拟验证与真机验收。
先定义统一能力,再展开平台列
首先固定与业务相关的能力契约,例如 login() 返回已登录、拒绝或失败;storage 能写入并回读存档;生命周期恢复后能重新拉取必要状态;分享能发起或清晰回退。接着为每项能力列出正常、拒绝或异常路径,最后映射到目标运行平台。
下面是以 Web Mobile、微信小游戏和 Android 原生包为例的验证骨架。表中写的是应执行的检查,不代表任何渠道已经通过,也不代表所有能力都已开通。
| 能力 | Web Mobile | 微信小游戏 | Android 原生 |
|---|---|---|---|
| 登录 | 登录、拒绝、凭证失效 | 授权拒绝、返回游戏、登录态失效 | 授权取消、账号切换、重进 |
| 存储 | 写读、刷新、配额不足 | 写读、重启、缓存清理 | 写读、进程重启、数据迁移 |
| 生命周期 | 切标签、锁屏、返回 | 切出微信、回到游戏 | Home 切后台、恢复、进程被杀 |
| 分享 | 唤起能力、不可用回退 | 分享入口、取消或结果不可辨 | 插件可用性、取消和替代入口 |
| 支付(若接入) | 渠道合规性、订单查询 | 支付资质、取消、结果核验 | 商店规则、取消、恢复与核验 |
矩阵的基本单位是一个可追溯用例,例如 wechat / lifecycle / hide-show,而非“微信平台测试通过”。对无授权能力或政策不允许的组合,记为“不适用”,附上原因和审核人,不能简单删除行列。
用可观察结果定义通过条件
登录用例需要检查拒绝授权后是否保持游客态、是否错误展示已登录 UI,以及重新授权后能否恢复。不要只检查 SDK 是否回调。存储要验证“写入 → 退出或重启 → 回读”,并检查写入失败时是否有提示,不能把内存中的值误认为持久化成功。
生命周期要分别覆盖正常切后台返回和进程被系统终止后的冷启动。前者应避免重复注册事件、重复播放音乐或丢失暂停状态;后者需要从持久化数据或服务端重建,不能假设一定收到后台事件。Web 上的可见性或隐藏事件也不保证覆盖所有系统中断。
分享和支付应覆盖“能力缺失、用户取消、渠道回调迟到、断网”这几类差异。验收依据是业务能否正确降级、订单是否仍由服务端确认,而不是弹窗能否出现。需要测试的维度包括设备、系统版本、渠道 SDK 版本、网络状态和构建版本,优先选一台真实设备验证每条关键路径。
用脚本发现未登记的测试组合
下面的 Node.js 示例把四项能力各拆成两个场景,展开三个平台后检查记录缺口。它只验证计划是否有对应记录,不能替代真实 SDK 或真机测试。保存为 coverage-check.mjs:
const platforms = ['web', 'wechat', 'android'];
const scenarios = {
login: ['success', 'denied'],
storage: ['readback', 'restart'],
lifecycle: ['hide-show', 'restore'],
share: ['invoke', 'fallback'],
};
// 示例记录不是测试通过证明,真实项目应从测试报告导入。
const recorded = new Set([
'web|login|success',
'web|login|denied',
'web|storage|readback',
]);
const planned = platforms.flatMap((platform) =>
Object.entries(scenarios).flatMap(([ability, cases]) =>
cases.map((item) => `${platform}|${ability}|${item}`)
)
);
const missing = planned.filter((id) => !recorded.has(id));
console.log(`计划 ${planned.length} 项;已登记 ${recorded.size} 项;缺口 ${missing.length} 项`);
console.log(`首个缺口:${missing[0] ?? '无'}`);运行命令:
node coverage-check.mjs预期输出:
计划 24 项;已登记 3 项;缺口 21 项
首个缺口:web|storage|restart脚本里的 recorded 仅为演示数据,不表示 Web 已被验证。实际项目应当为每个用例保存 PASS、FAIL、BLOCKED 或 N/A 状态,并记录测试设备、构建版本、操作步骤、日志和截图或录屏证据。N/A 必须有理由;如果某渠道启用支付,应把支付的取消、待确认、重复通知和订单恢复场景加入计划。
将模拟、真机和发布门禁分层
日常提交可以用模拟适配器快速覆盖业务分支,比如登录拒绝不解锁账号、分享不可用展示替代入口、支付结果未知不发货。但模拟器和编辑器不能验证真实宿主的授权弹窗、后台调度、存储配额或渠道政策,关键路径必须在目标真机与正式签名或审核允许的测试包中复验。
执行时先跑所有平台共用的能力契约测试,再测试各渠道适配器,最后安排弱网、重启、账号切换和真实回调的端到端回归。每条失败记录都应能定位到“业务规则、适配器、SDK、运行宿主或服务端”中的一个层级;修复后复测该用例并检查其他平台的相同能力。
发布门禁应明确:登录与存档不可出现阻断性故障,生命周期恢复不能导致资产或状态错误,涉及真实资金的订单核验必须完整通过;非关键分享入口允许按设计回退,但不得谎报成功。最终按能力查看覆盖率和遗留风险,才能知道跨平台发布是否真正可控。