Agent Skills
返回列表
💻

Godot 4 导出与构建

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 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 与签名分发流程的移动/桌面发布同学