跳到主要内容

开发者工具与真机验证闭环

适用:Cocos Creator 3.8.8 构建的微信小游戏验证方法。资料核查:2026-11-17。已读取微信官方开发者工具概览,具体界面与操作以当前工具为准;本节是操作与证据设计,未执行开发者工具编译、扫码或真机测试。

四种通过分别证明什么​

浏览器预览证明共享逻辑在浏览器环境工作;Cocos 微信构建证明工程能生成目标产物;开发者工具编译与模拟器证明一部分平台适配;微信真机证明实际设备与宿主上的行为。它们是逐层补充的证据,不能互相替代。桌面浏览器的移动设备模式只模拟部分尺寸和输入条件,不会变成真实微信运行时。

测试记录先填状态:通过、失败、未执行、被环境阻塞。缺少账号、二维码或设备时标清阻塞条件,不能让 AI 把未执行自动改成通过。一个可信报告可能包含很多未执行项;一个所有项目都写通过却没有产物身份和日志的报告,无法指导发布。

先让工具打开正确的项目​

将开发者工具导入路径指向 Cocos 的微信产物目录,核对 AppID、编译类型、项目根路径与版本标识。官方示例配置中可看到 game 类型与目录设置,但示例的基础库和调试选项不是本项目推荐默认值。工具界面与字段会随版本变化,因此操作步骤应以当前工具实际显示为准,记录工具版本,而不执着于某张旧截图的按钮位置。

首次进入只检查最小闭环:启动画面、首场景加载、一次输入、暂停恢复与一次结算。先消除首个报错,再扩大到完整功能。模拟器能显示界面时,也要查看网络请求与控制台,加载失败可能被占位资源掩盖。重复导入多个近似项目很容易看错,调试信息页中的唯一构建标识能有效减少混淆。

把宽松选项当作诊断变量​

开发工具可能提供忽略部分校验、调试基础库、缓存清理等设置。它们可以帮助定位问题,但打开某个宽松选项后成功,只说明你隔离了一个条件,不能说明正式环境已经满足要求。网络域名、证书、权限和平台能力仍需按正式条件核对。报告记录关键开关,不能把它们藏在截图之外。

先用正式校验路径复测,再做扫码预览。不要为使工具通过而将生产请求降级为不安全协议,也不要把测试账号绕过逻辑留进发布包。若需要临时替身,调试界面必须清楚标记替身状态,并有构建检查防止它进入正式配置。

真机矩阵由风险决定​

至少覆盖项目实际面向的系统与设备档位,重点选择内存紧、GPU 性能较低或屏幕形状特殊的代表设备。不是机械列出十几台新手机,而是让每台设备回答一个风险。记录系统、微信版本、基础库、机型、画质档位、网络条件和构建标识,才能比较差异。高性能模式或不同渲染配置应作为独立维度测试。

场景主要观察需要的证据
冷启动首关下载、黑屏、首次可玩时间点、网络与画面
连续战斗帧时间、温升后变化固定流程、统计区间
多次切关资源峰值与释放每轮内存和资源数量
前后台恢复输入、音频、网络恢复日志与录像
弱网与断网超时、重试、幂等阶段与服务端结果

真机扫码打开的具体包也要确认版本。有时缓存和体验版入口让人误以为新构建已经生效。先看构建标识,再开始计时。冷缓存测试应说明如何清理,热缓存测试应说明预热流程;别把一次网络下载较快的结果写成稳定首屏表现。

性能测试与远程调试分开记录​

远程调试会增加通信、日志与采样开销,某些调试环境还可能改变执行方式。先用它定位问题,再在接近发布条件下验证改善;不要混用两组数字做结论。固定初始状态、操作脚本、敌人数量、时长和画质,尽量多次运行,并记录是否充电、设备温度及后台负载等会影响结果的条件。

平均 FPS 无法说明一次很长的卡顿。记录帧时间分布、最长停顿、资源加载峰值与内存趋势。出现退后台或闪退时保留终止前阶段和设备日志,不能仅凭 JS 堆正常就排除内存问题。Cocos 的 iOS 微信优化文章提供了内存层次分析,但其中历史机型数字不应当作当前所有设备的统一限额。

故障证据包要能被别人复现​

一条有效缺陷记录包括:构建标识、环境、前置状态、最短操作、预期、实际、频率、日志时间范围与附件。截图适合说明布局,录像适合说明输入和时序,日志适合定位异步阶段,服务端记录适合判断是否已提交。缺少任何一类时写清楚,不要用“偶尔黑屏”代替可追踪的问题。

定位时比较最小差异:同包在两台设备、同机在两种配置、同配置在两个版本。一次只改变一个主要变量。若浏览器正常而微信失败,回到运行时边界;若只在冷启动出现,回到加载流程;若连续切关后才出现,检查资源所有权和监听泄漏。

把单次测试写成可重复操作​

以切关测试为例,明确从全新启动进入首关,执行固定次数攻击,返回大厅,等待资源处理稳定,再进入第二关;每轮在同一阶段采集数据。若每次观察点不同,峰值与基线会混在一起。记录异常发生在第几轮,并保留最后一轮成功与首次失败的阶段数据,可帮助判断累积泄漏还是单个资源异常。

对设备限制无法完全控制的条件,保留现场事实比强行标准化更有价值。设备发热、系统来电、网络切换和微信升级都可能改变结果。把这些作为测试环境的一部分记录,后续复测才知道什么需要保持一致,什么是新的风险维度。

交给 AI 的任务与验收​

可复制任务:“为当前微信候选包生成分层验证表,浏览器、Cocos 构建、开发者工具与真机分别记录。设计首关、切后台、断网重连、连续切关和发布模式测试,给每项前置条件、步骤、观察指标与证据字段;无运行证据必须标未执行。”

验收任一通过项都能追溯到具体产物和环境;第一条有效错误能复现;弱网后业务状态唯一;至少能区分冷缓存与热缓存结果。若设备未准备好,交付的是可执行测试清单和明确限制,不能声称微信已通过。

官方来源​