游戏引擎 / 系统课时
怎样统一检查移动端首包
怎样统一检查移动端首包
同一份 Cocos Creator 3.8 工程在编辑器能运行,不代表 Android 或 iOS 首次安装后就可用。本课以安装、冷启动、首屏、资源加载和日志五个关口,建立每次出包都能重复执行的验收基线。
学习目标
- 划定首包验收范围,统一设备、构建配置和测试条件。
- 按启动顺序检查安装、画面、资源及异常日志。
- 使用 Android 调试命令保留可复查的启动证据。
先固定测试条件
这里的“首包”指准备交给测试人员的首个移动端安装产物,不等同于小游戏的主包大小。Cocos Creator 中通过“项目 → 构建发布”选择 Android 或 iOS,确认启动场景、包标识、横竖屏及资源服务器配置,再完成原生工程编译,得到可安装产物。构建成功只表示产物生成,不代表通过运行验收。
至少记录引擎版本、构建任务、安装包版本、设备系统与型号、网络状态。第一次验收优先执行卸载后的全新安装;覆盖安装应另立一轮,因为旧缓存和持久化数据可能掩盖首包缺陷。卸载会清除应用数据,只在测试设备上执行。
沿启动链路设置验收关口

| 关口 | 通过标准 | 保留证据 |
|---|---|---|
| 安装 | 设备可安装,图标、名称、包标识符合当前构建 | 安装结果与版本信息 |
| 冷启动 | 结束进程后能打开,无闪退、长时间黑屏或错误方向 | 启动录像与设备信息 |
| 首屏 | 正确进入指定场景,文字、图片和按钮可见且能响应 | 首屏截图和交互记录 |
| 资源 | 首屏依赖的图集、音频与场景加载完整;远程资源失败有合理反馈 | 网络条件及失败资源线索 |
| 日志 | 无导致启动失败的脚本异常、资源错误或原生崩溃 | 启动期间原始日志 |
通过时间不应凭感觉判断。可把“点击图标到首屏可操作”的耗时记为基线,并注明设备与网络;后续版本用相同条件比较。若首屏依赖远程资源,再测一次断网或弱网,确认不会无限停留在加载画面。
用 Android 命令复现安装与冷启动
以下以 Android 调试包为主示例。准备启用 USB 调试的设备、可用的 Android SDK Platform-Tools 和已编译好的 APK。把 <PATH> 换成实际 APK 路径,<ID> 换成构建时设置的 Android 应用包名;双引号用于避免路径中的空格干扰命令。
adb devices
adb install -r "<PATH>"
adb shell am force-stop "<ID>"
adb shell monkey -p "<ID>" -c android.intent.category.LAUNCHER 1预期输出(截取关键行,设备编号和其余提示随环境变化):
List of devices attached
<DEVICE_ID> device
Success
Events injected: 1Success 只表示安装完成,Events injected: 1 只表示启动事件已注入;仍须肉眼确认首屏和交互。若要验证真正的首次安装,应先在测试设备上卸载旧版本,再执行安装命令。iOS 则使用 Xcode 安装、运行并在设备控制台查看同样的验收维度,不能直接复用 adb。
把日志和失败现象对应起来
在设备完成一次启动后执行以下命令,将最近的系统日志保存到当前目录。必要时先清理旧日志并重新复现,避免把其他应用或旧会话的错误误判为本次首包问题。
adb logcat -d -t 1500 > first-launch.log预期结果:当前目录生成 first-launch.log;命令通常不在终端打印内容。打开文件,结合包名、启动时间、异常堆栈和资源路径判断错误来源。日志量及可见内容与设备、构建模式有关,发布包没有普通调试打印不等于没有发生错误。
遇到安装失败先核对签名、系统兼容性与剩余空间;启动闪退先查原生崩溃与引擎初始化;黑屏或缺图再检查启动场景引用、资源路径大小写、远程地址和下载失败。每个问题记录“包版本—设备—重现步骤—预期/实际—截图或日志”,修复后从安装重新走完五关,而不只验证出错的一步。