游戏引擎 / 系统课时
完成上线前客户端检查
完成上线前客户端检查
上线前的最后一轮验证,不是再随意玩一遍,而是对同一个候选安装包留下可复核的通过证据。本课按场景、存档、输入、UI、性能和异常日志执行检查,使用一段小型烟测脚本辅助发现基础缺陷,并明确何时应阻止发布。
学习目标
- 建立覆盖六类关键风险的客户端验收清单。
- 在真实构建中自动检查启动场景和存档目录的基本可用性。
- 根据日志、复现步骤和性能预算作出放行或返工决定。
先固定要验收的候选包
为候选包记录版本号、源码提交、目标平台、构建配置、资源版本、设备型号和操作系统版本。测试期间不随意替换二进制或远端资源;一旦改动,相关检查结果就不再自动适用于新包。
至少区分全新安装与从上一正式版本覆盖升级两种状态,并准备正常网络、断网或弱网场景。先用 Development Build 收集详细日志,再用最终发布配置复测启动、资源加载与主要交互,避免只测试带调试开关的客户端。
用六类场景建立验收矩阵
| 检查范围 | 实际操作 | 最低通过条件 |
|---|---|---|
| 场景 | 冷启动、菜单进游戏、返回、连续切换与重新进入 | 场景均能加载,无黑屏、缺资源或重复初始化 |
| 存档 | 创建进度、退出重启、修改设置、覆盖升级旧版本 | 数据可恢复;升级不损坏已有进度;异常档有受控处理 |
| 输入 | 测试目标平台的键鼠、手柄或触控;切后台后恢复 | 移动、确认、返回和暂停不丢失、不重复触发 |
| UI | 检查窄屏、异形屏安全区、不同语言和大字号 | 关键按钮可点击,文字不被遮挡,提示层级正确 |
| 性能 | 预热后测试典型战斗、切场景、长时间运行 | 帧时间、内存和 GC 峰值满足项目既定预算 |
| 异常日志 | 断网、资源加载失败、保存失败等可控故障演练 | 错误可提示或恢复,无未处理异常与持续刷屏日志 |
性能不能只看平均 FPS。若项目目标是 60 FPS,单帧预算约为 16.7 ms,还应记录较慢帧、内存增长及加载卡顿;最终阈值应按目标设备档位事先确定,而不是把这一数字当作所有平台的统一标准。

在实际构建中做一次自动烟测
把下面的 ReleaseSmokeProbe.cs 挂在启动场景的启用对象上,确认场景已加入构建列表,再制作 Development Build。它只检查当前场景是否被纳入构建,以及测试文件能否往返读写;不会代替完整的存档升级、UI 或性能测试。
using System;
using System.IO;
using UnityEngine;
using UnityEngine.SceneManagement;
public sealed class ReleaseSmokeProbe : MonoBehaviour
{
private void Start()
{
#if DEVELOPMENT_BUILD || UNITY_EDITOR
// 避免仅在编辑器中存在、却未纳入构建的场景漏检。
bool sceneOk = SceneManager.GetActiveScene().buildIndex >= 0;
Debug.Log("Scene listed: " + (sceneOk ? "PASS" : "FAIL"));
if (string.IsNullOrEmpty(Application.persistentDataPath))
{
Debug.LogError("Save roundtrip: FAIL no persistentDataPath");
return;
}
string path = Path.Combine(Application.persistentDataPath, "release-probe.tmp");
try
{
// 独立测试文件,不覆盖正式存档。
File.WriteAllText(path, "release-check");
bool ok = File.ReadAllText(path) == "release-check";
Debug.Log("Save roundtrip: " + (ok ? "PASS" : "FAIL"));
}
catch (Exception e)
{
Debug.LogError("Save roundtrip: FAIL " + e.GetType().Name);
}
finally
{
try { if (File.Exists(path)) File.Delete(path); }
catch (Exception e) { Debug.LogWarning("Cleanup: FAIL " + e.GetType().Name); }
}
#endif
}
}预期输出(启动场景已纳入构建、持久目录可写时):
Scene listed: PASS
Save roundtrip: PASS如果出现 FAIL,先记录设备及完整日志,再检查场景构建列表或目录状态。这段代码不会在普通非 Development Build 中执行探测;若发布平台不支持 persistentDataPath,必须采用该平台的存储方案,不能把写入成功当作默认前提。
根据阻断标准决定能否发布
崩溃、无法进入核心场景、旧档损坏、主操作失效、关键按钮不可达,以及典型设备上持续超出性能预算,都应作为阻断问题。每个问题需要保存候选包版本、复现步骤、期望与实际结果、设备信息和对应日志,而不只写一句“偶发卡顿”。
缺陷修复后重新构建,先复测受影响功能,再跑启动、场景切换、存档和异常日志等核心回归。正式放行前,还要对最终签名与发布配置的安装包做一次冷启动和升级安装验证,确认与测试过的候选内容一致。