# 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 校验值。