游戏引擎 / 系统课时

为桌面平台准备发布包

为桌面平台准备发布包

桌面发布失败常来自漏带数据文件、错误架构或测试时依赖开发环境。本课按平台整理可分发目录,在干净位置启动并保存日志,再核对输入、路径、窗口和签名等平台条件。

学习目标

  • 能为目标桌面平台整理完整发布目录
  • 能在隔离环境检查启动和关键功能

每个平台各自建立预设

在 Project → Export 分别添加 Windows Desktop、Linux 或 macOS 预设,名称包含目标架构和发布用途。记录对应引擎、模板及 .NET 使用情况。导出另一个系统的包不代表能在当前系统运行;必须在目标系统验收。

窗口尺寸、缩放、渲染器与输入映射先在项目中确定。桌面鼠标键盘、手柄和高 DPI 行为各有测试场景;不要用移动版默认触控 UI 直接充当桌面入口。图标、产品名和版本字段也应与发布记录一致。

原生扩展、托管运行时和外部动态库要按架构准备。一个 x86_64 的游戏不能靠另一个架构的插件补齐;C# 项目还应按当前平台导出文档核对运行要求。启动失败时先查架构与缺依赖,不优先重写游戏逻辑。

分发完整产物而非单个文件

Windows 包通常包含可执行文件和项目数据,是否嵌入 PCK 取决于预设。Linux 要保留游戏二进制的可执行权限,并携带外置 PCK 与依赖。macOS 按导出结果分发应用包或归档,签名和公证需要相应工具、身份与实际验证,不是导出后自动完成。

将目标包复制到新目录,目录名包含空格和非 ASCII 字符,再测试启动,确认没有依赖源码、临时文件或编辑器缓存。若选择外置数据文件,保持预期文件名和相对位置;启动时不要默认用户从包目录打开终端。

下面是 Linux 发布目录内的完整启动检查脚本,保存为 check-start.sh,与 Game.x86_64 和外置数据放在一起。先按预设获得真实产物,再在 Linux 终端执行 bash check-start.sh;本课没有运行目标系统包。

bash
#!/usr/bin/env bash
set -u
# 从脚本所在目录启动,避免调用者的当前目录影响检查。
cd -- "$(dirname -- "$0")" || exit 1
if [ ! -f ./Game.x86_64 ]; then
  printf 'binary missing\n' >&2
  exit 1
fi
chmod u+x ./Game.x86_64
./Game.x86_64 --log-file "$PWD/startup.log"
status=$?
printf 'exit=%s\n' "$status"
exit "$status"

预期输出(应用正常启动并正常退出时,省略游戏日志):

text
exit=0

游戏会保持运行,需在可见窗口中完成检查再正常退出。startup.log 用于定位启动错误,退出码零本身不能证明输入和画面正确;异常退出或二进制缺失应保留原始输出,而不是修改预期掩盖失败。

用小流程验收桌面差异

启动主场景,调整窗口尺寸和全屏,检查 UI 不被截断;操作键盘鼠标与支持的手柄,验证焦点切换、音频和退出确认。读取旧存档并保存新数据,重启后复核。不同显示刷新率与缩放比例也要覆盖。

检查包所在目录不可写时仍能运行,用户数据应进入 user://。若插件依赖系统库,使用干净测试环境验证最低系统条件。Windows 的防护提示、macOS 的签名公证与 Linux 的发行版依赖要按平台处理,不能靠开发机“点过允许”作为发布证据。

归档可追溯的包

保存平台、架构、构建编号、哈希、日志和设备验收记录,压缩后再解压复测一次。目标系统未测就写未测,不能用 headless 引擎检查代替图形启动。最终交付目录应能明确对应唯一版本,并完整包含玩家启动所需文件。

平台边界见 Windows export、Linux export 与 macOS export。

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

目录与阅读设置

记录一个想法

为桌面平台准备发布包

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

登录哪都通