Files
whale-town-front-v2/DESKTOP_BUILD.md
xiangwang fc6c3c1bd3 feat: expand multiplayer, chat, and release support
- add network NPC synchronization and dialogue interactions
- add world bulletin publishing and display
- improve authentication, session refresh, and appearance sync
- synchronize player direction and movement animations
- improve input focus and progressive Web loading
- add macOS/Windows builds and deployment configuration
- include required fonts, shaders, and runtime assets
2026-09-08 21:37:43 +08:00

1.7 KiB
Raw Blame History

WhaleTown 桌面客户端构建

桌面客户端和 Web 客户端使用同一套 Godot 项目、正式登录接口和 WebSocket 服务。用户下载客户端后直接进入登录页,账号数据仍由线上服务保存,不写入项目目录。

构建目标

  • macOSbuild/desktop/macos/WhaleTown.app,通用架构,支持 Apple Silicon 和 Intel Mac。
  • Windowsbuild/desktop/windows/WhaleTown.exe64 位桌面版本。

环境要求

  1. 安装与项目一致的 Godot 4.6.2.stable
  2. 在 Godot 编辑器的导出模板管理器中安装 macOS 和 Windows Desktop 模板。
  3. 默认网络配置位于 Config/game_config.json,发布前确认 production 地址指向正式服务。

构建命令

whale-town-front-v2 目录执行:

./scripts/build_desktop.sh macos
./scripts/build_desktop.sh windows
./scripts/build_desktop.sh all
./scripts/build_desktop.sh release

release 会同时构建两个平台,生成 ZIP并在 build/desktop/release/SHA256SUMS.txt 写入校验值。也可以通过 GODOT_BIN=/path/to/GodotWHALETOWN_VERSION=1.0.0 指定 Godot 路径及发布版本。

Windows 构建可以从 macOS 交叉导出,但最终发布前仍应在真实 Windows 机器上启动一次,确认显卡、字体、文件选择器和网络连接正常。

面向用户发布

首版可以直接将 build/desktop/release 中的 ZIP 供内测下载。正式公开下载前还需要:

  • macOS 使用 Apple Developer ID 签名和 notarization避免 Gatekeeper 拦截。
  • Windows 使用代码签名证书,降低 SmartScreen 警告。
  • 将客户端压缩包上传到下载站,并提供版本号、更新日期和 SHA-256 校验值。