forked from moyin/whale-town-front
164 lines
3.7 KiB
Markdown
164 lines
3.7 KiB
Markdown
# 鲸鱼镇 Web导出脚本
|
||
|
||
这个目录包含了将鲸鱼镇项目导出为Web版本的完整脚本集合。
|
||
|
||
## 📁 文件说明
|
||
|
||
### Windows脚本
|
||
- `build_web.bat` - Web版本导出脚本
|
||
- `serve_web.bat` - 本地测试服务器脚本
|
||
|
||
### Linux/macOS脚本
|
||
- `build_web.sh` - Web版本导出脚本
|
||
- `serve_web.sh` - 本地测试服务器脚本
|
||
|
||
## 🚀 快速开始
|
||
|
||
### Windows用户
|
||
|
||
1. **导出Web版本**
|
||
```cmd
|
||
scripts\build_web.bat
|
||
```
|
||
|
||
2. **启动本地测试服务器**
|
||
```cmd
|
||
scripts\serve_web.bat
|
||
```
|
||
|
||
### Linux/macOS用户
|
||
|
||
1. **添加执行权限**（首次使用）
|
||
```bash
|
||
chmod +x scripts/build_web.sh scripts/serve_web.sh
|
||
```
|
||
|
||
2. **导出Web版本**
|
||
```bash
|
||
./scripts/build_web.sh
|
||
```
|
||
|
||
3. **启动本地测试服务器**
|
||
```bash
|
||
./scripts/serve_web.sh
|
||
```
|
||
|
||
## ⚙️ 配置要求
|
||
|
||
### 系统要求
|
||
- **Godot Engine**: 4.5+
|
||
- **Python**: 3.6+（用于本地测试服务器）
|
||
- **磁盘空间**: 至少100MB
|
||
|
||
### Godot配置
|
||
在使用脚本前，请确保：
|
||
1. 已安装Godot 4.5或更高版本
|
||
2. 已下载Web导出模板
|
||
3. 已创建名为"Web"的导出预设
|
||
|
||
## 🔧 脚本配置
|
||
|
||
### 修改Godot路径
|
||
如果Godot安装在非默认位置，请修改脚本中的路径：
|
||
|
||
**Windows** (`build_web.bat`):
|
||
```batch
|
||
set "GODOT_PATH=C:\Program Files\Godot\Godot.exe"
|
||
```
|
||
|
||
**Linux/macOS** (`build_web.sh`):
|
||
```bash
|
||
GODOT_PATH="/usr/local/bin/godot"
|
||
```
|
||
|
||
### 修改端口设置
|
||
默认使用端口8000，如需修改请编辑服务器脚本：
|
||
|
||
**Windows** (`serve_web.bat`):
|
||
```batch
|
||
set "PORT=8000"
|
||
```
|
||
|
||
**Linux/macOS** (`serve_web.sh`):
|
||
```bash
|
||
PORT=8000
|
||
```
|
||
|
||
## 📋 使用流程
|
||
|
||
1. **准备阶段**
|
||
- 确保Godot已正确安装
|
||
- 在Godot编辑器中创建Web导出预设
|
||
- 下载对应版本的导出模板
|
||
|
||
2. **导出阶段**
|
||
- 运行导出脚本
|
||
- 等待导出完成
|
||
- 检查生成的文件
|
||
|
||
3. **测试阶段**
|
||
- 运行本地服务器脚本
|
||
- 在浏览器中测试功能
|
||
- 检查控制台错误
|
||
|
||
4. **部署阶段**
|
||
- 将`build/web/`目录上传到服务器
|
||
- 配置服务器MIME类型和CORS
|
||
- 测试线上版本
|
||
|
||
## 🐛 常见问题
|
||
|
||
### Godot未找到
|
||
**错误**: `未找到Godot可执行文件`
|
||
**解决**: 修改脚本中的`GODOT_PATH`变量为正确路径
|
||
|
||
### 导出预设不存在
|
||
**错误**: `导出预设 "Web" 不存在`
|
||
**解决**: 在Godot编辑器中创建Web导出预设
|
||
|
||
### Python未安装
|
||
**错误**: `未找到Python`
|
||
**解决**: 安装Python 3.6+并确保添加到PATH
|
||
|
||
### 端口被占用
|
||
**错误**: `端口 8000 已被占用`
|
||
**解决**: 脚本会自动尝试8080端口，或手动修改端口设置
|
||
|
||
### 文件缺失
|
||
**错误**: `缺少必要文件`
|
||
**解决**: 重新运行导出脚本，检查Godot配置
|
||
|
||
## 📊 输出文件
|
||
|
||
导出成功后，`build/web/`目录将包含：
|
||
|
||
```
|
||
build/web/
|
||
├── index.html # 主HTML文件
|
||
├── index.js # JavaScript引导文件
|
||
├── index.wasm # WebAssembly主文件
|
||
├── index.pck # Godot资源包
|
||
├── index.worker.js # Web Worker文件
|
||
├── .htaccess # Apache配置文件
|
||
├── deploy_info.json # 部署信息
|
||
└── server.log # 服务器日志（测试时生成）
|
||
```
|
||
|
||
## 🔗 相关文档
|
||
|
||
- [完整部署指南](../docs/web_deployment_guide.md)
|
||
- [更新日志](../docs/web_deployment_changelog.md)
|
||
- [API文档](../docs/api-documentation.md)
|
||
|
||
## 💡 提示
|
||
|
||
1. **首次导出**可能需要较长时间下载模板
|
||
2. **文件较大**时建议启用服务器压缩
|
||
3. **移动端测试**请使用真机而非模拟器
|
||
4. **网络问题**可能影响API调用，注意CORS配置
|
||
|
||
---
|
||
|
||
**维护**: 鲸鱼镇开发团队
|
||
**版本**: 1.0.0
|
||
**更新**: 2025-12-25 |