游戏引擎 / 系统课时

配置第一个正式导出预设

配置第一个正式导出预设

编辑器内能运行的项目还不是正式发布包。本课创建一个可复查的 Windows 正式导出预设,核对模板、主场景和资源范围,再用命令行构建并检查产物,让发布配置不依赖一次临时点击。

学习目标

  • 能创建正式导出预设并区分资源包与可运行包
  • 能检查命令行导出的路径、退出码与产物

检查主场景与模板

本课使用 Godot 4.7.2 的普通 GDScript 项目。先在 Project → Project Settings → Application → Run 确认 Main Scene,按 F5 能从正确入口运行。C# 项目还需对应 .NET 引擎与模板,不能用普通引擎的检查代表托管代码发布。

通过 Editor → Manage Export Templates 查看与当前引擎匹配的平台模板,勾选目标平台和架构后使用 Install Selected Templates,或从匹配版本的 TPZ 安装。中文、日文、韩文及 emoji 还要核对 ICU Data。不要混用另一个引擎版本的模板,缺 SDK 或签名工具时按预设错误逐条解决。

窗口尺寸、内容缩放和渲染方法主要属于项目设置,并非每个平台都有同名导出开关。先记录这些设置和目标平台能力,避免把想象中的“导出时自动优化画质”作为发布策略。发行性能应来自真实发布构建。

建立命名明确的正式预设

打开 Project → Export,Add → Windows Desktop,将预设命名为 Windows Release。选择目标架构和输出位置,检查产品名、图标及版本字段。在 Resources 页选择符合项目需求的资源范围,并保留动态加载所需文件。

诊断与正式构建分开命名。图形导出对话框中正式包取消 Export With Debug;命令行使用 --export-release。PCK/ZIP 只包含资源数据,不能把单独导出的资源包当成可运行游戏发给玩家。

导出配置写在 export_presets.cfg,可以纳入版本控制;当前版本把凭据放在 .godot/export_credentials.cfg 等专用位置。新机器需要恢复必要凭据或使用受控环境配置,但不要把密码、密钥加入公开仓库。

用完整命令确认输出位置

保存下面的 PowerShell 入口为 build.ps1,传入自己的引擎和项目绝对路径。先完成编辑器预设与模板安装再运行;本课环境未安装完整导出链,下面是需要在构建机执行的操作示例。

powershell
param(
    [Parameter(Mandatory)][string]$GodotExe,
    [Parameter(Mandatory)][string]$ProjectDir
)
$ErrorActionPreference = 'Stop'
$projectPath = (Resolve-Path -LiteralPath $ProjectDir).Path
if (-not (Test-Path -LiteralPath $GodotExe -PathType Leaf)) { throw 'Engine missing' }
if (-not (Test-Path -LiteralPath (Join-Path $projectPath 'project.godot'))) { throw 'Project missing' }
# 每轮使用UTC时间和GUID组成独立目录,不把陈旧产物算作本次输出。
$buildName = 'build/windows-release-' + [DateTime]::UtcNow.ToString('yyyyMMdd-HHmmss') + '-' + [guid]::NewGuid().ToString('N')
$buildDir = Join-Path $projectPath $buildName
New-Item -ItemType Directory -Path $buildDir -Force | Out-Null
$outputFile = Join-Path $buildDir 'Game.exe'
# 显式引用带空格路径;GUI版引擎需要等待并读取真实进程退出码。
$exportArgs = @('--headless', '--path', ('"' + $projectPath + '"'), '--export-release', '"Windows Release"', ('"' + $outputFile + '"'))
$stdoutLog = Join-Path $buildDir 'export-stdout.log'
$stderrLog = Join-Path $buildDir 'export-stderr.log'
$exportProcess = Start-Process -FilePath $GodotExe -ArgumentList $exportArgs -Wait -PassThru -WindowStyle Hidden -RedirectStandardOutput $stdoutLog -RedirectStandardError $stderrLog
if ($exportProcess.ExitCode -ne 0) { throw 'Export failed; inspect export logs' }
if (-not (Test-Path -LiteralPath $outputFile -PathType Leaf)) { throw 'Output missing' }
Write-Output 'exported=Game.exe'

预期输出(仅在成功导出时,省略引擎自己的日志):

text
exported=Game.exe

调用时用 -GodotExe 和 -ProjectDir 指定路径;脚本每轮产生带 UTC 时间与 GUID 的独立目录,保留以前产物,避免把旧文件误当成新构建。GUI 版引擎需要等待进程并读取其 ExitCode,不能依赖直接调用后留下的旧 $LASTEXITCODE。将该目录与本轮版本编号绑定,两个导出日志也要归档。

在编辑器之外验收

复制整个导出目录到不依赖项目源码的位置,再启动 Game.exe,检查主场景、输入、音频和存档。PCK 未嵌入时需要随可执行文件一起分发;外部插件与运行库也应按目标配置携带,不能只压缩一个看起来最大的文件。

缺模板通常表现为导出阶段报错,入口错误或动态资源缺失可能到启动后才出现。将构建失败与运行失败分别记录,确认确实启动了刚导出的版本。可运行、功能正确、符合性能预算,是三项独立检查,只有第一项通过不能称正式包验收完成。

预设与资源范围见 Exporting projects,参数见 Command line tutorial。

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

目录与阅读设置

记录一个想法

配置第一个正式导出预设

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

登录哪都通