- 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
1.7 KiB
1.7 KiB
WhaleTown 桌面客户端构建
桌面客户端和 Web 客户端使用同一套 Godot 项目、正式登录接口和 WebSocket 服务。用户下载客户端后直接进入登录页,账号数据仍由线上服务保存,不写入项目目录。
构建目标
- macOS:
build/desktop/macos/WhaleTown.app,通用架构,支持 Apple Silicon 和 Intel Mac。 - Windows:
build/desktop/windows/WhaleTown.exe,64 位桌面版本。
环境要求
- 安装与项目一致的 Godot
4.6.2.stable。 - 在 Godot 编辑器的导出模板管理器中安装 macOS 和 Windows Desktop 模板。
- 默认网络配置位于
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/Godot 和 WHALETOWN_VERSION=1.0.0 指定 Godot 路径及发布版本。
Windows 构建可以从 macOS 交叉导出,但最终发布前仍应在真实 Windows 机器上启动一次,确认显卡、字体、文件选择器和网络连接正常。
面向用户发布
首版可以直接将 build/desktop/release 中的 ZIP 供内测下载。正式公开下载前还需要:
- macOS 使用 Apple Developer ID 签名和 notarization,避免 Gatekeeper 拦截。
- Windows 使用代码签名证书,降低 SmartScreen 警告。
- 将客户端压缩包上传到下载站,并提供版本号、更新日期和 SHA-256 校验值。