跳到主要内容

微信小游戏构建与设备验收

桌面浏览器能运行,证明Web资源链路可用;微信构建成功,证明构建工具生成了目标平台产物。这两者都不能直接证明目标手机的画面、性能和生命周期行为正确。

本站执行到哪一层​

本站提供 Creator 工程与微信构建配置,实际构建命令如下。具体执行结果见验证记录。账号登录、上传发布和手机真机测试不属于首版完成条件。

node examples/cocos/tools/build.mjs wechatgame

产物在examples/cocos/build/wechatgame,应有game.js、game.json和project.config.json等文件。示例使用官方文档列出的测试AppID wx6ac3f5090a6b99c5;真实项目按自己的小游戏账号与权限配置。

开发者工具验收​

  1. 用微信开发者工具导入构建目录,确认项目类型与AppID。
  2. 检查资源请求、脚本与着色器相关错误。
  3. 观察透明边缘、模型材质、动画循环和屏幕尺寸下的布局。
  4. 验证切后台再回前台后,动画、加载和资源状态符合预期。
  5. 记录工具版本、基础库、构建设置和错误日志。

构建配置中的方向等设置只是输入,最终以微信工具读取的产物与实际运行效果为准。不要手工修改产物后忘记将修复反映回源工程。

真机验收矩阵​

检查项要观察的证据
兼容性代表性iOS/Android设备、微信版本、图形表现
加载冷启动、弱网、首次下载与再次进入
内存峰值、重复进入场景、释放后的趋势
帧时间同时出现目标数量角色、UI与特效时的稳定性
生命周期前后台切换、音频/动画恢复、资源重建
视觉透明、纹理压缩、材质、骨骼动画与色彩

设备测试记录应该包含机型、系统、微信版本、测试场景、资源数量与测量方法。不要把本机桌面60FPS变成“微信小游戏都能60FPS”的承诺。

向 AI 分派平台问题​

桌面Web正常,Android微信真机机器人不显示,金币正常。
附设备/系统/微信/基础库版本与控制台错误。
请先比较模型资源加载、材质和蒙皮组件,
给出逐项缩小问题的最小测试,不要立即重建全部资源。

文档站仅支持桌面浏览器,与游戏资源是否需要手机真机验证是两件事;前者是本站阅读范围,后者由你的游戏上线目标决定。

官方阅读:发布到微信小游戏。平台限制与配额可能变化,应在正式发布时重新核对官方资料。