游戏引擎 / 系统课时

完成上线前客户端检查

完成上线前客户端检查

上线前的最后一轮验证,不是再随意玩一遍,而是对同一个候选安装包留下可复核的通过证据。本课按场景、存档、输入、UI、性能和异常日志执行检查,使用一段小型烟测脚本辅助发现基础缺陷,并明确何时应阻止发布。

学习目标

  • 建立覆盖六类关键风险的客户端验收清单。
  • 在真实构建中自动检查启动场景和存档目录的基本可用性。
  • 根据日志、复现步骤和性能预算作出放行或返工决定。

先固定要验收的候选包

为候选包记录版本号、源码提交、目标平台、构建配置、资源版本、设备型号和操作系统版本。测试期间不随意替换二进制或远端资源;一旦改动,相关检查结果就不再自动适用于新包。

至少区分全新安装与从上一正式版本覆盖升级两种状态,并准备正常网络、断网或弱网场景。先用 Development Build 收集详细日志,再用最终发布配置复测启动、资源加载与主要交互,避免只测试带调试开关的客户端。

用六类场景建立验收矩阵

检查范围 实际操作 最低通过条件
场景 冷启动、菜单进游戏、返回、连续切换与重新进入 场景均能加载,无黑屏、缺资源或重复初始化
存档 创建进度、退出重启、修改设置、覆盖升级旧版本 数据可恢复;升级不损坏已有进度;异常档有受控处理
输入 测试目标平台的键鼠、手柄或触控;切后台后恢复 移动、确认、返回和暂停不丢失、不重复触发
UI 检查窄屏、异形屏安全区、不同语言和大字号 关键按钮可点击,文字不被遮挡,提示层级正确
性能 预热后测试典型战斗、切场景、长时间运行 帧时间、内存和 GC 峰值满足项目既定预算
异常日志 断网、资源加载失败、保存失败等可控故障演练 错误可提示或恢复,无未处理异常与持续刷屏日志

性能不能只看平均 FPS。若项目目标是 60 FPS,单帧预算约为 16.7 ms,还应记录较慢帧、内存增长及加载卡顿;最终阈值应按目标设备档位事先确定,而不是把这一数字当作所有平台的统一标准。

客户端候选包的六类验证与发布门禁流程

在实际构建中做一次自动烟测

把下面的 ReleaseSmokeProbe.cs 挂在启动场景的启用对象上,确认场景已加入构建列表,再制作 Development Build。它只检查当前场景是否被纳入构建,以及测试文件能否往返读写;不会代替完整的存档升级、UI 或性能测试。

csharp
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
    }
}

预期输出(启动场景已纳入构建、持久目录可写时):

text
Scene listed: PASS
Save roundtrip: PASS

如果出现 FAIL,先记录设备及完整日志,再检查场景构建列表或目录状态。这段代码不会在普通非 Development Build 中执行探测;若发布平台不支持 persistentDataPath,必须采用该平台的存储方案,不能把写入成功当作默认前提。

根据阻断标准决定能否发布

崩溃、无法进入核心场景、旧档损坏、主操作失效、关键按钮不可达,以及典型设备上持续超出性能预算,都应作为阻断问题。每个问题需要保存候选包版本、复现步骤、期望与实际结果、设备信息和对应日志,而不只写一句“偶发卡顿”。

缺陷修复后重新构建,先复测受影响功能,再跑启动、场景切换、存档和异常日志等核心回归。正式放行前,还要对最终签名与发布配置的安装包做一次冷启动和升级安装验证,确认与测试过的候选内容一致。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

完成上线前客户端检查

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通