Godot 4 导出与构建
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/godot-export-sh-ig907a。
技能介绍
要解决什么问题
游戏要交给玩家或 CI 跑,不能只在编辑器里点运行。Godot 4.3+ 需要与编辑器版本完全一致的导出模板、在 export_presets.cfg 里维护各平台预设,并从编辑器或无头命令行打出 release/debug 包。Web(HTML5)和专用服(headless)还有各自坑:线程与 COOP/COEP、运行时只能写 user:// 等。
技能覆盖的核心流程
- 模板与预设:通过 Manage Export Templates 或离线
.tpz安装模板;在 Project > Export 里选平台、路径、图标、特性标签,以及资源包含/排除与非资源文件过滤(如*.json)。 - 导出方式:编辑器 Export Project / Export PCK/ZIP;自动化用
--export-release "预设名" .(预设名大小写与空格必须一致,例如"Windows Desktop"而非"Windows")。 - 常见模式:CI 无头导出、headless 跑专用服或测试、运行时识别构建上下文、持久化路径避开只读的
res://。 - 分平台要点:Web 需 HTTP(S) 与跨源隔离头;Android 需 SDK/JDK、keystore 与网络权限;macOS/iOS 分发需签名/公证。
适用边界
不适合走 Steam/itch 上架流程(见 steam-publish / itch-publish),也不替代多人联机服务端逻辑(见 godot-multiplayer;本技能侧重把专用服打成 headless 构建)。发版前在目标环境做冒烟测试;对外发布用 --export-release,调试才用 --export-debug。更细的 CLI 标志、export_presets.cfg 结构、加密与分平台配置见技能内 references。
使用场景
- 在 GitHub Actions 里用 `--export-release` 按预设名自动打出 Windows/Linux release 包
- itch 或自建站点发布 Web 版前,排查线程与 SharedArrayBuffer 所需的 COOP/COEP 响应头
- 多人项目要把专用服工程导出为 headless 二进制,在机房或容器里无界面跑服
- 升级 Godot 小版本后构建报 No export template found,需对齐模板并重检 `export_presets.cfg`
适合人员
- 用 Godot 4 做独立游戏、需要在 jam 或 EA 前快速打出 Web/桌面包的开发者
- 负责把 Godot 项目接入 Jenkins/GitLab CI、要求可重复 release 构建的构建工程师
- 做 Godot 联机项目、要把服务端单独导出并在 Linux 服务器 headless 运行的后端开发者
- 首次配置 Android/macOS 导出,需要理清 SDK、keystore 与签名分发流程的移动/桌面发布同学