zijunchiang
9f7b926a9a
- README.md / README.txt 新增初次部署章节：前置条件、获取代码、首次运行、 配置服务端地址（API 3000 / 管理端 3001 分离）、与 Android 的 WebSocket 联通、 打包导出、自检清单、常见问题 - 三库同源契约：':=' 写法修回、去掉真实 MariaDB 版本串 - 全文去除易被 Gitea 判为「模棱两可 Unicode」的字符（- - ... -> 取代 — – … § →） - 真实内网地址与库名改占位符
2.0 KiB
2.0 KiB
T-WIN-011 Windows 打包脚本
- 状态：done
- 依赖：T-WIN-001 ~ 010
目标
提供 Linux 直接导出（方案 A，推荐）与 Windows 端兜底（方案 B）两条打包路径。
load
DSH.md
build/export-windows.sh
build/export-windows.ps1
export_presets.cfg
交付物
| 文件 | 说明 |
|---|---|
export_presets.cfg |
导出预设（必须在项目根目录，Godot 硬性要求） |
build/export-windows.sh |
Linux 导出：定位 Godot -> 检查模板 -> 导入 -> 导出 -> 校验 PE 头 |
build/export-windows.ps1 |
Windows 兜底：同上，产物路径与校验逻辑一致 |
脚本健壮性
GODOT_BIN环境变量或 PATH 自动定位 Godot，缺失时给出可执行的安装指引- 导出模板缺失时明确报错并给出下载与安装路径
- 导出命令返回非 0 时仍检查产物是否存在（Godot 有时非 0 返回但产物有效）
- 读取产物前 2 字节校验
MZ（PE 头），防止导出静默产出空壳
验收（文档 5.4）
| 验收项 | 结果 |
|---|---|
Linux：bash build/export-windows.sh 成功生成 exe |
✅ 生成 OpenDance.exe 104 MB + OpenDance.pck 107 KB，PE 头校验通过 |
Windows：powershell build/export-windows.ps1 成功生成 exe |
⚠️ 脚本就绪，本环境无 Windows，未实机执行 |
| 生成的 exe 在 Windows 10/11 可运行 | ⚠️ 本环境无 Windows；已校验为合法 PE32+ x86_64 可执行文件 |
THIRD_PARTY.md 包含所有开源项目与源链接 |
✅ 15 项，与契约表逐条一致 |
打包产物
opendance-windows-v0.1.0.zip
├── OpenDance.exe
├── OpenDance.pck
├── THIRD_PARTY.md
├── README.txt
└── contracts/ # 契约快照
环境记录
- Godot 4.7.2.stable（
ed1daf0bf） - 导出模板
4.7.2.stable（windows_release_x86_64.exe） - 首次导出失败原因：
export_presets.cfg放在build/下，Godot 只在项目根目录查找