游戏引擎 / 系统课时

配置目标平台并完成导出

配置目标平台并完成导出

本课以 Godot 4 的 Windows Desktop 平台为例,将已通过本地测试的 3D 小游戏导出为可交付的构建产物。完成后,你将得到能在目标系统独立启动的可执行文件,并掌握模板缺失、资源遗漏和构建后运行失败的基本排查方法。

学习目标

  • 准备匹配编辑器版本的导出模板,并建立目标平台预设。
  • 设置资源打包范围,使用图形界面或命令完成发布导出。
  • 检查交付目录,并在不依赖项目源码的环境中验证运行。

准备平台导出环境

先在编辑器中按 F5 验证项目主场景能够启动,并确认使用的 Godot 4 版本。打开 Editor > Manage Export Templates,安装与当前编辑器版本匹配的导出模板;离线环境可通过模板管理器导入预先下载的模板文件。

导出模板负责生成目标平台的游戏运行程序,与用于编辑场景的 Godot 编辑器不是同一份产物。如果导出窗口提示模板缺失或版本不匹配,应先补齐模板,而不是反复调整游戏资源。

建立 Windows Desktop 预设

选择 Project > Export...,点击 Add... 新建 Windows Desktop 预设。首次交付建议先使用易于核对的资源范围,确认成品完整启动后,再根据体积需求缩减资源。

Godot 4 中 Windows Desktop 导出预设和资源选项的真实界面

按以下要点检查预设:

  1. 预设名称保持为 Windows Desktop,确保后续命令中的名称与 export_presets.cfg 完全一致。
  2. 在平台选项中按目标设备选择处理器架构;普通 64 位 Intel/AMD Windows 电脑通常使用 x86_64。
  3. 在 Resources 中先选择导出所有项目资源。如果使用了 FileAccess 读取 .json、.csv 等文件,再设置非资源文件的包含过滤规则。
  4. 选择项目目录之外的输出位置,避免构建产物混入项目资源。需要可运行的游戏时选择 Export Project,不能只导出 PCK/ZIP 资源包。

对资源采用“仅导出所选场景及其依赖”的策略时,尤其要注意运行时按字符串加载的其他关卡或角色资源:它们可能未被静态依赖自动覆盖。先完成全资源发布验证,再考虑精简更容易定位问题。

执行发布构建

图形界面可以直接点击 Export Project 保存目标程序;自动化构建则使用 --export-release。预设保存在项目根目录的 export_presets.cfg,因此应先通过界面创建并保存预设,才能按名称从命令行选择它。

以下为 Windows PowerShell 可执行示例。执行前把 <PROJECT_PATH> 换成项目目录、<OUTPUT_PATH> 换成项目之外的导出目录,并确保 godot 命令可用;若未配置环境变量,可将命令名换成 Godot 编辑器可执行文件的实际路径。

powershell
# 输出目录必须在导出前建立
New-Item -ItemType Directory -Force -Path "<OUTPUT_PATH>" | Out-Null
godot --headless --path "<PROJECT_PATH>" --export-release "Windows Desktop" "<OUTPUT_PATH>/MiniGame.exe"
# 失败时停止,不把旧文件误判成这次导出的成果
if ($LASTEXITCODE -ne 0) { throw "Godot 导出失败" }
if (-not (Test-Path "<OUTPUT_PATH>/MiniGame.exe" -PathType Leaf)) { throw "未找到可执行文件" }
Write-Output "导出文件已生成"

预期输出(Godot 自身可能另有进度日志,以下为脚本最后一行):

text
导出文件已生成

生成 .exe 只证明构建步骤通过,不代表所有依赖都已正确随包提供。导出实际产生了单独的 .pck 时,必须连同程序一起交付;如果资源已嵌入程序,则无需额外复制 .pck。

在独立环境中验收

把整个导出目录复制到一台符合目标架构的 Windows 机器,或至少复制到不含项目源码的新目录,从 MiniGame.exe 启动。不要在编辑器内用 F5 代替成品验收。建议实际完成进入菜单、开始关卡、角色控制、模型和纹理显示、音效播放、场景切换及退出这些关键操作。

现象 优先检查
导出按钮不可用或提示模板缺失 导出模板是否安装且版本一致
命令报告找不到预设 export_presets.cfg 是否存在、名称是否为 Windows Desktop
构建成功但模型或配置缺失 Resources 筛选、动态路径及非资源文件包含规则
文件复制后无法运行 是否漏带 .pck、目标架构是否正确,以及程序启动时的错误日志

交付时保留可复现的预设配置,并将最终验证过的构建目录整体打包。只有在没有编辑器和项目源码参与的情况下,入口与核心玩法仍能正常运行,才算完成一次可交付的导出。

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

目录与阅读设置

阅读设置

17

记录一个想法

配置目标平台并完成导出

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

登录哪都通