xiangwang
fc6c3c1bd3
- 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
38 lines
1.7 KiB
Markdown
38 lines
1.7 KiB
Markdown
# WhaleTown 桌面客户端构建
|
||
|
||
桌面客户端和 Web 客户端使用同一套 Godot 项目、正式登录接口和 WebSocket 服务。用户下载客户端后直接进入登录页，账号数据仍由线上服务保存，不写入项目目录。
|
||
|
||
## 构建目标
|
||
|
||
- macOS：`build/desktop/macos/WhaleTown.app`，通用架构，支持 Apple Silicon 和 Intel Mac。
|
||
- Windows：`build/desktop/windows/WhaleTown.exe`，64 位桌面版本。
|
||
|
||
## 环境要求
|
||
|
||
1. 安装与项目一致的 Godot `4.6.2.stable`。
|
||
2. 在 Godot 编辑器的导出模板管理器中安装 macOS 和 Windows Desktop 模板。
|
||
3. 默认网络配置位于 `Config/game_config.json`，发布前确认 `production` 地址指向正式服务。
|
||
|
||
## 构建命令
|
||
|
||
在 `whale-town-front-v2` 目录执行：
|
||
|
||
```bash
|
||
./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 校验值。
|