游戏引擎 / 系统课时

验证发布包中的核心流程

验证发布包中的核心流程

编辑器中能顺利运行,不代表导出的游戏在玩家电脑上也能找到资源并完成玩法。本课使用脱离工程目录的真实发布包,串联首次启动、移动、交互、界面反馈与关卡切换,建立可以重复执行的交付验收流程。

学习目标

  • 区分编辑器运行与独立发布包运行的验证边界。
  • 按真实玩家操作顺序检查核心流程并记录缺陷。
  • 在修复后重新导出,用同一套用例完成回归。

在独立环境首次启动

从 Godot 4 的「项目 → 导出」选择目标平台的预设,使用「导出项目」生成完整可运行包。先确认导出模板已安装、目标操作系统与 CPU 架构匹配,并保留该平台导出所需的全部伴随文件;单独的 PCK 资源包不能直接当作游戏运行。

将发布文件复制到项目目录之外的新文件夹,最好在没有安装 Godot 编辑器的目标设备上运行。不要从 res:// 工程目录启动,也不要依赖编辑器已缓存的导入资源。首次测试建议使用干净的系统用户或测试账号,避免旧存档、旧配置掩盖首次启动问题;不要删除真实玩家数据。

观察窗口能否正常出现、主场景是否正确、贴图与音频是否完整,以及输入设备是否生效。若程序可以打开但画面黑屏,应先检查启动场景、导出资源筛选规则、渲染器与目标设备兼容性,而不是直接把“进程已启动”视为通过。

用命令确认发布程序能独立运行

以下是 Linux 桌面导出包的可运行冒烟检查脚本。将其保存为 smoke.sh,在终端执行 bash smoke.sh "<PATH>",用实际发布程序路径替换 <PATH>;该程序必须具有可执行权限。Windows、macOS 可采用对应系统的文件管理器或终端直接启动发布应用。

bash
#!/usr/bin/env bash
set -euo pipefail
game_path="${1:?请提供发布可执行文件路径}"

# 验证真实导出程序,不要传入 Godot 编辑器本体
if [[ ! -f "$game_path" || ! -x "$game_path" ]]; then
  printf 'FAIL: 发布文件不存在或不可执行\n'
  exit 1
fi

printf 'PASS: 发布文件检查通过\n'
"$game_path"
# 正常退出只证明进程层面无非零退出码
printf 'PASS: 进程正常退出;请核对人工流程记录\n'

预期输出(发布游戏正常退出时;游戏自身的日志可能穿插其中):

text
PASS: 发布文件检查通过
PASS: 进程正常退出;请核对人工流程记录

如果路径错误或文件没有执行权限,脚本会输出 FAIL 并停止;如果游戏以非零状态退出,最后一行 PASS 不会出现。命令只能检查文件和退出状态,不能替代实际操作、视觉检查与关卡验收。

沿玩家路径检查每个反馈点

按「启动 → 进入关卡 → 移动 → 交互 → UI 反馈 → 切换场景」的顺序测试,不要只在场景编辑器里单独运行某一关。每完成一步就确认游戏状态与屏幕反馈一致;若有暂停、失败重试或返回菜单,也要覆盖一次。

发布包从启动到关卡切换的验收路径及失败回归分支

检查点 实际操作 通过标准
启动 双击发布程序,选择开始 主场景加载,无缺失资源或异常退出
移动 持续移动、转向、跳跃并停止 角色响应正确,不穿墙、不持续漂移
交互 靠近对象并触发交互动作 命中目标正确,交互效果只触发预期次数
UI 观察准星、提示、数值与暂停界面 内容随状态更新,暂停与恢复输入正常
场景 过关或执行场景切换,再返回或重试 目标场景正确加载,角色与 UI 状态没有错误继承

记录缺陷并重新验收

记录测试的发布版本、平台、系统版本、操作步骤、期望结果、实际结果和日志位置。崩溃、无法启动、无法移动或不能切关属于阻断交付的问题;贴图缺失、提示错位等也应按影响程度追踪,不要只写“偶尔有问题”。

特别检查发布包与编辑器的资源差异:通过 FileAccess 读取的非资源文件可能需要在导出预设中显式包含;存档和运行时数据应写入 user://,不能假设打包后的 res:// 可写。修复后必须重新导出并在同样的独立环境复测,而不是只在编辑器里验证。

只有完整执行关键路径、记录的阻断问题已经关闭,并且目标平台上的重新运行结果可复现,才应把这一版标为可交付。

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

目录与阅读设置

阅读设置

17

记录一个想法

验证发布包中的核心流程

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

登录哪都通