forked from datawhale/whale-town-front
refactor：重构项目架构为分层结构
## 🏗️ 主要变更 ### 目录结构重构 - 将 core/ 迁移到 _Core/（框架层） - 将 scenes/ 重构为 Scenes/（玩法层）和 UI/（界面层） - 将 data/ 迁移到 Config/（配置层） - 添加 Assets/ 资源层和 Utils/ 工具层 - 将 scripts/ 迁移到 tools/（开发工具） ### 架构分层 - **_Core/**: 框架层 - 全局单例和管理器 - **Scenes/**: 玩法层 - 游戏场景和实体 - **UI/**: 界面层 - HUD、窗口、对话系统 - **Assets/**: 资源层 - 精灵图、音频、字体 - **Config/**: 配置层 - 游戏配置和本地化 - **Utils/**: 工具层 - 通用辅助脚本 ### 文件更新 - 更新 project.godot 中的所有路径引用 - 更新自动加载脚本路径 - 更新测试文件的引用路径 - 添加 REFACTORING.md 详细说明 - 添加 MIGRATION_COMPLETE.md 迁移完成标记 - 更新 README.md 反映新架构 ### 设计原则 - ✅ 清晰的分层（框架/玩法/界面） - ✅ 场景内聚（脚本紧邻场景文件） - ✅ 组件化设计（可复用组件） - ✅ 职责单一（每个目录职责明确） ## 📋 详细信息 查看 REFACTORING.md 了解完整的重构说明和迁移映射表 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
王浩
191
tools/README.md
Normal file
191
tools/README.md
Normal file
@@ -0,0 +1,191 @@
|
||||
# 🛠️ 构建和部署工具
|
||||
|
||||
本目录包含项目的构建和部署脚本。
|
||||
|
||||
---
|
||||
|
||||
## 📦 Web 构建工具
|
||||
|
||||
### build_web.sh (Linux/macOS)
|
||||
### build_web.bat (Windows)
|
||||
|
||||
**功能**: 将 Godot 项目导出为 Web 版本
|
||||
|
||||
#### 使用方法
|
||||
|
||||
**macOS/Linux:**
|
||||
```bash
|
||||
chmod +x tools/build_web.sh
|
||||
./tools/build_web.sh
|
||||
```
|
||||
|
||||
**Windows:**
|
||||
```cmd
|
||||
tools\build_web.bat
|
||||
```
|
||||
|
||||
#### 输出目录
|
||||
- `build/web/` - 导出的 Web 游戏文件
|
||||
|
||||
#### 导出内容包括:
|
||||
- `index.html` - Web 入口文件
|
||||
- `index.js` - 游戏主逻辑
|
||||
- `index.wasm` - WebAssembly 文件
|
||||
- `index.pck` - 游戏资源包
|
||||
|
||||
---
|
||||
|
||||
## 🌐 Web 测试服务器
|
||||
|
||||
### serve_web.sh (Linux/macOS)
|
||||
### serve_web.bat (Windows)
|
||||
|
||||
**功能**: 启动本地 HTTP 服务器预览 Web 游戏
|
||||
|
||||
#### 使用方法
|
||||
|
||||
**macOS/Linux:**
|
||||
```bash
|
||||
chmod +x tools/serve_web.sh
|
||||
./tools/serve_web.sh
|
||||
```
|
||||
|
||||
**Windows:**
|
||||
```cmd
|
||||
tools\serve_web.bat
|
||||
```
|
||||
|
||||
#### 访问地址
|
||||
- 默认: `http://localhost:8000`
|
||||
- 浏览器会自动打开
|
||||
|
||||
#### 注意事项
|
||||
⚠️ **必须使用 HTTP 服务器**
|
||||
- 不能直接用 `file://` 打开 `index.html`
|
||||
- Godot Web 版本需要 HTTP 环境
|
||||
- 本服务器已配置正确的 CORS 头
|
||||
|
||||
---
|
||||
|
||||
## 🔧 配置说明
|
||||
|
||||
### 修改 Godot 路径
|
||||
|
||||
编辑脚本中的 `GODOT_PATH` 变量：
|
||||
|
||||
**macOS:**
|
||||
```bash
|
||||
GODOT_PATH="/usr/local/bin/godot" # Homebrew
|
||||
# 或
|
||||
GODOT_PATH="$HOME/Applications/Godot.app/Contents/MacOS/Godot" # 应用程序
|
||||
```
|
||||
|
||||
**Windows:**
|
||||
```batch
|
||||
set GODOT_PATH=C:\Program Files\Godot\godot.exe
|
||||
```
|
||||
|
||||
**Linux:**
|
||||
```bash
|
||||
GODOT_PATH="/usr/bin/godot" # 包管理器
|
||||
# 或
|
||||
GODOT_PATH="$HOME/bin/godot" # 手动安装
|
||||
```
|
||||
|
||||
### 修改端口
|
||||
|
||||
编辑 `serve_web.sh` 或 `serve_web.bat` 中的端口配置：
|
||||
```bash
|
||||
PORT=8080 # 改为其他端口
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📋 典型工作流程
|
||||
|
||||
### 1. 开发阶段
|
||||
在 Godot 编辑器中开发和测试游戏
|
||||
|
||||
### 2. 导出 Web 版本
|
||||
```bash
|
||||
./tools/build_web.sh
|
||||
```
|
||||
|
||||
### 3. 本地测试
|
||||
```bash
|
||||
./tools/serve_web.sh
|
||||
# 浏览器访问 http://localhost:8000
|
||||
```
|
||||
|
||||
### 4. 部署到服务器
|
||||
将 `build/web/` 目录的内容上传到你的 Web 服务器
|
||||
|
||||
---
|
||||
|
||||
## 🌍 部署平台示例
|
||||
|
||||
### GitHub Pages
|
||||
```bash
|
||||
./tools/build_web.sh
|
||||
# 将 build/web/ 推送到 gh-pages 分支
|
||||
```
|
||||
|
||||
### Netlify
|
||||
```bash
|
||||
# 直接拖拽 build/web/ 目录到 Netlify
|
||||
```
|
||||
|
||||
### Vercel
|
||||
```bash
|
||||
./tools/build_web.sh
|
||||
vercel --prod build/web/
|
||||
```
|
||||
|
||||
### 自己的服务器
|
||||
```bash
|
||||
scp -r build/web/* user@server:/var/www/html/
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ 常见问题
|
||||
|
||||
### 问题 1: 找不到 Godot
|
||||
**解决方案**: 修改脚本中的 `GODOT_PATH` 变量
|
||||
|
||||
### 问题 2: 权限不足 (macOS/Linux)
|
||||
**解决方案**:
|
||||
```bash
|
||||
chmod +x tools/build_web.sh tools/serve_web.sh
|
||||
```
|
||||
|
||||
### 问题 3: 浏览器无法加载游戏
|
||||
**原因**: 必须使用 HTTP 服务器，不能用 `file://`
|
||||
**解决方案**: 使用 `serve_web.sh` 启动本地服务器
|
||||
|
||||
### 问题 4: 游戏黑屏
|
||||
**检查**:
|
||||
- 浏览器控制台是否有错误
|
||||
- WebAssembly 是否启用
|
||||
- 是否在 HTTPS 或 localhost 环境下运行
|
||||
|
||||
---
|
||||
|
||||
## 📚 相关文档
|
||||
|
||||
- [Godot Web 导出文档](https://docs.godotengine.org/en/stable/tutorials/export/exporting_for_web.html)
|
||||
- [Web 服务器配置](https://docs.godotengine.org/en/stable/tutorials/export/binary_files_for_web_games.html)
|
||||
- [项目 Web 部署指南](../docs/web_deployment_guide.md)
|
||||
|
||||
---
|
||||
|
||||
## 🎯 下一步
|
||||
|
||||
1. 确保安装了 Godot 4.5+
|
||||
2. 运行 `./tools/build_web.sh` 测试导出
|
||||
3. 运行 `./tools/serve_web.sh` 本地预览
|
||||
4. 根据需要修改配置参数
|
||||
|
||||
---
|
||||
|
||||
**祝你发布顺利！** 🚀
|
||||
235
tools/build_web.bat
Normal file
235
tools/build_web.bat
Normal file
@@ -0,0 +1,235 @@
|
||||
@echo off
|
||||
setlocal enabledelayedexpansion
|
||||
|
||||
echo ========================================
|
||||
echo 鲸鱼镇 Web版本导出工具 v1.0
|
||||
echo ========================================
|
||||
echo.
|
||||
|
||||
REM 配置变量 - 请根据实际情况修改
|
||||
set "PROJECT_NAME=whaleTown"
|
||||
set "BUILD_DIR=build\web"
|
||||
set "GODOT_PATH=D:\technology\biancheng\Godot\Godot_v4.5.1-stable_win64.exe"
|
||||
set "EXPORT_PRESET=Web"
|
||||
set "VERSION=1.0.0"
|
||||
|
||||
REM 颜色代码（Windows 10+）
|
||||
set "RED=[91m"
|
||||
set "GREEN=[92m"
|
||||
set "YELLOW=[93m"
|
||||
set "BLUE=[94m"
|
||||
set "RESET=[0m"
|
||||
|
||||
REM 检查Godot是否存在
|
||||
echo %BLUE%[检查]%RESET% 验证Godot安装...
|
||||
if not exist "%GODOT_PATH%" (
|
||||
echo %RED%[错误]%RESET% 未找到Godot可执行文件: %GODOT_PATH%
|
||||
echo 请修改脚本中的GODOT_PATH变量或安装Godot 4.5+
|
||||
echo 下载地址: https://godotengine.org/download
|
||||
echo.
|
||||
pause
|
||||
exit /b 1
|
||||
)
|
||||
|
||||
REM 检查项目文件
|
||||
echo %BLUE%[检查]%RESET% 验证项目文件...
|
||||
if not exist "project.godot" (
|
||||
echo %RED%[错误]%RESET% 未找到project.godot文件！
|
||||
echo 请在项目根目录运行此脚本
|
||||
echo.
|
||||
pause
|
||||
exit /b 1
|
||||
)
|
||||
|
||||
REM 显示项目信息
|
||||
echo %GREEN%[信息]%RESET% 项目信息:
|
||||
echo 项目名称: %PROJECT_NAME%
|
||||
echo 版本号: %VERSION%
|
||||
echo Godot路径: %GODOT_PATH%
|
||||
echo 导出预设: %EXPORT_PRESET%
|
||||
echo 输出目录: %BUILD_DIR%
|
||||
echo.
|
||||
|
||||
REM 创建构建目录结构
|
||||
echo %BLUE%[构建]%RESET% 准备构建环境...
|
||||
if not exist "build" mkdir "build"
|
||||
if not exist "%BUILD_DIR%" mkdir "%BUILD_DIR%"
|
||||
if not exist "scripts" mkdir "scripts"
|
||||
|
||||
REM 备份旧版本（如果存在）
|
||||
if exist "%BUILD_DIR%\index.html" (
|
||||
echo %YELLOW%[备份]%RESET% 备份旧版本...
|
||||
set "BACKUP_DIR=build\backup\%date:~0,4%%date:~5,2%%date:~8,2%_%time:~0,2%%time:~3,2%%time:~6,2%"
|
||||
set "BACKUP_DIR=!BACKUP_DIR: =0!"
|
||||
mkdir "!BACKUP_DIR!" 2>nul
|
||||
xcopy "%BUILD_DIR%\*" "!BACKUP_DIR%\" /Y /Q >nul 2>&1
|
||||
echo 备份位置: !BACKUP_DIR!\
|
||||
)
|
||||
|
||||
REM 清理旧文件
|
||||
echo %BLUE%[清理]%RESET% 清理旧的导出文件...
|
||||
if exist "%BUILD_DIR%\*" del /q "%BUILD_DIR%\*" >nul 2>&1
|
||||
|
||||
REM 检查导出预设
|
||||
echo %BLUE%[验证]%RESET% 检查导出预设...
|
||||
"%GODOT_PATH%" --headless --export-debug "%EXPORT_PRESET%" --check-only >nul 2>&1
|
||||
if %ERRORLEVEL% neq 0 (
|
||||
echo %RED%[错误]%RESET% 导出预设 "%EXPORT_PRESET%" 不存在或配置错误！
|
||||
echo 请在Godot编辑器中创建Web导出预设
|
||||
echo.
|
||||
pause
|
||||
exit /b 1
|
||||
)
|
||||
|
||||
REM 导出项目
|
||||
echo %GREEN%[导出]%RESET% 开始导出Web版本...
|
||||
echo 目标文件: %BUILD_DIR%\index.html
|
||||
echo 请稍候...
|
||||
echo.
|
||||
|
||||
"%GODOT_PATH%" --headless --export-release "%EXPORT_PRESET%" "%BUILD_DIR%\index.html"
|
||||
|
||||
if %ERRORLEVEL% neq 0 (
|
||||
echo %RED%[失败]%RESET% 导出失败！错误代码: %ERRORLEVEL%
|
||||
echo.
|
||||
echo 可能的原因:
|
||||
echo 1. 导出模板未安装
|
||||
echo 2. 项目配置错误
|
||||
echo 3. 资源文件损坏
|
||||
echo.
|
||||
pause
|
||||
exit /b %ERRORLEVEL%
|
||||
)
|
||||
|
||||
REM 验证导出文件
|
||||
echo %BLUE%[验证]%RESET% 验证导出文件...
|
||||
set "REQUIRED_FILES=index.html index.js index.wasm index.pck"
|
||||
set "MISSING_FILES="
|
||||
|
||||
for %%f in (%REQUIRED_FILES%) do (
|
||||
if not exist "%BUILD_DIR%\%%f" (
|
||||
set "MISSING_FILES=!MISSING_FILES! %%f"
|
||||
)
|
||||
)
|
||||
|
||||
if not "!MISSING_FILES!"=="" (
|
||||
echo %RED%[错误]%RESET% 缺少必要文件:!MISSING_FILES!
|
||||
echo 导出可能不完整，请检查Godot配置
|
||||
echo.
|
||||
pause
|
||||
exit /b 1
|
||||
)
|
||||
|
||||
REM 复制额外资源
|
||||
echo %BLUE%[复制]%RESET% 复制额外资源...
|
||||
if exist "assets\web\favicon.ico" copy "assets\web\favicon.ico" "%BUILD_DIR%\" >nul 2>&1
|
||||
if exist "assets\web\manifest.json" copy "assets\web\manifest.json" "%BUILD_DIR%\" >nul 2>&1
|
||||
if exist "assets\web\service-worker.js" copy "assets\web\service-worker.js" "%BUILD_DIR%\" >nul 2>&1
|
||||
if exist "assets\web\custom_shell.html" copy "assets\web\custom_shell.html" "%BUILD_DIR%\" >nul 2>&1
|
||||
|
||||
REM 生成部署信息
|
||||
echo %BLUE%[生成]%RESET% 生成部署信息...
|
||||
(
|
||||
echo {
|
||||
echo "project": "%PROJECT_NAME%",
|
||||
echo "version": "%VERSION%",
|
||||
echo "build_time": "%date% %time%",
|
||||
echo "platform": "web",
|
||||
echo "godot_version": "4.5",
|
||||
echo "export_preset": "%EXPORT_PRESET%",
|
||||
echo "build_machine": "%COMPUTERNAME%",
|
||||
echo "build_user": "%USERNAME%"
|
||||
echo }
|
||||
) > "%BUILD_DIR%\deploy_info.json"
|
||||
|
||||
REM 生成.htaccess文件
|
||||
echo %BLUE%[配置]%RESET% 生成Apache配置文件...
|
||||
(
|
||||
echo # 鲸鱼镇 Web版本 Apache配置
|
||||
echo # 自动生成于 %date% %time%
|
||||
echo.
|
||||
echo # MIME类型配置
|
||||
echo AddType application/wasm .wasm
|
||||
echo AddType application/octet-stream .pck
|
||||
echo AddType application/javascript .js
|
||||
echo.
|
||||
echo # 启用压缩
|
||||
echo ^<IfModule mod_deflate.c^>
|
||||
echo AddOutputFilterByType DEFLATE text/html text/css application/javascript application/wasm
|
||||
echo AddOutputFilterByType DEFLATE application/json application/xml
|
||||
echo ^</IfModule^>
|
||||
echo.
|
||||
echo # 缓存控制
|
||||
echo ^<IfModule mod_expires.c^>
|
||||
echo ExpiresActive On
|
||||
echo ExpiresByType application/wasm "access plus 1 month"
|
||||
echo ExpiresByType application/octet-stream "access plus 1 month"
|
||||
echo ExpiresByType application/javascript "access plus 1 week"
|
||||
echo ExpiresByType text/html "access plus 1 hour"
|
||||
echo ^</IfModule^>
|
||||
echo.
|
||||
echo # CORS配置
|
||||
echo ^<IfModule mod_headers.c^>
|
||||
echo Header set Access-Control-Allow-Origin "*"
|
||||
echo Header set Access-Control-Allow-Methods "GET, POST, PUT, DELETE, OPTIONS"
|
||||
echo Header set Access-Control-Allow-Headers "Content-Type, Authorization"
|
||||
echo Header set Cross-Origin-Embedder-Policy "require-corp"
|
||||
echo Header set Cross-Origin-Opener-Policy "same-origin"
|
||||
echo ^</IfModule^>
|
||||
) > "%BUILD_DIR%\.htaccess"
|
||||
|
||||
REM 计算文件大小
|
||||
echo %BLUE%[统计]%RESET% 计算文件大小...
|
||||
set "TOTAL_SIZE=0"
|
||||
for %%f in ("%BUILD_DIR%\*") do (
|
||||
set /a "TOTAL_SIZE+=%%~zf"
|
||||
)
|
||||
set /a "TOTAL_MB=TOTAL_SIZE/1024/1024"
|
||||
|
||||
REM 显示构建结果
|
||||
echo.
|
||||
echo ========================================
|
||||
echo %GREEN% 导出成功！%RESET%
|
||||
echo ========================================
|
||||
echo.
|
||||
echo %GREEN%[完成]%RESET% 构建统计:
|
||||
echo 导出位置: %BUILD_DIR%\
|
||||
echo 总文件大小: %TOTAL_MB% MB
|
||||
echo 构建时间: %date% %time%
|
||||
echo.
|
||||
echo %BLUE%[文件]%RESET% 导出文件列表:
|
||||
for %%f in ("%BUILD_DIR%\*") do (
|
||||
set "size=%%~zf"
|
||||
set /a "size_mb=!size!/1024/1024"
|
||||
if !size_mb! gtr 0 (
|
||||
echo %%~nxf: !size_mb! MB
|
||||
) else (
|
||||
set /a "size_kb=!size!/1024"
|
||||
echo %%~nxf: !size_kb! KB
|
||||
)
|
||||
)
|
||||
|
||||
echo.
|
||||
echo %YELLOW%[下一步]%RESET% 部署选项:
|
||||
echo 1. 本地测试: scripts\serve_web.bat
|
||||
echo 2. 上传到服务器: 将 %BUILD_DIR%\ 目录上传
|
||||
echo 3. 查看文档: docs\web_deployment_guide.md
|
||||
echo.
|
||||
echo %GREEN%[提示]%RESET% 部署前请确保:
|
||||
echo - 服务器支持WASM MIME类型
|
||||
echo - 配置了正确的CORS头
|
||||
echo - 启用了文件压缩
|
||||
echo.
|
||||
|
||||
REM 询问是否启动本地服务器
|
||||
set /p "START_SERVER=是否启动本地测试服务器？(y/N): "
|
||||
if /i "!START_SERVER!"=="y" (
|
||||
echo.
|
||||
echo %GREEN%[启动]%RESET% 启动本地服务器...
|
||||
call "scripts\serve_web.bat"
|
||||
) else (
|
||||
echo.
|
||||
echo 构建完成！可以手动运行 scripts\serve_web.bat 进行测试
|
||||
)
|
||||
|
||||
pause
|
||||
238
tools/build_web.sh
Normal file
238
tools/build_web.sh
Normal file
@@ -0,0 +1,238 @@
|
||||
#!/bin/bash
|
||||
|
||||
# 鲸鱼镇 Web版本导出工具 (Linux/macOS)
|
||||
# 版本: 1.0.0
|
||||
|
||||
# 颜色定义
|
||||
RED='\033[0;31m'
|
||||
GREEN='\033[0;32m'
|
||||
YELLOW='\033[1;33m'
|
||||
BLUE='\033[0;34m'
|
||||
NC='\033[0m' # No Color
|
||||
|
||||
# 配置变量 - 请根据实际情况修改
|
||||
PROJECT_NAME="whaleTown"
|
||||
BUILD_DIR="build/web"
|
||||
GODOT_PATH="/usr/local/bin/godot" # macOS Homebrew默认路径
|
||||
# GODOT_PATH="/usr/bin/godot" # Linux包管理器默认路径
|
||||
# GODOT_PATH="$HOME/Applications/Godot.app/Contents/MacOS/Godot" # macOS应用程序路径
|
||||
EXPORT_PRESET="Web"
|
||||
VERSION="1.0.0"
|
||||
|
||||
echo "========================================"
|
||||
echo " 鲸鱼镇 Web版本导出工具 v1.0"
|
||||
echo "========================================"
|
||||
echo
|
||||
|
||||
# 检查Godot是否存在
|
||||
echo -e "${BLUE}[检查]${NC} 验证Godot安装..."
|
||||
if [ ! -f "$GODOT_PATH" ]; then
|
||||
echo -e "${RED}[错误]${NC} 未找到Godot: $GODOT_PATH"
|
||||
echo
|
||||
echo "请修改脚本中的GODOT_PATH变量或安装Godot 4.5+"
|
||||
echo "安装方法:"
|
||||
echo " macOS: brew install godot"
|
||||
echo " Ubuntu: sudo apt install godot3"
|
||||
echo " 或从官网下载: https://godotengine.org/download"
|
||||
echo
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# 检查项目文件
|
||||
echo -e "${BLUE}[检查]${NC} 验证项目文件..."
|
||||
if [ ! -f "project.godot" ]; then
|
||||
echo -e "${RED}[错误]${NC} 未找到project.godot文件！"
|
||||
echo "请在项目根目录运行此脚本"
|
||||
echo
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# 显示项目信息
|
||||
echo -e "${GREEN}[信息]${NC} 项目信息:"
|
||||
echo " 项目名称: $PROJECT_NAME"
|
||||
echo " 版本号: $VERSION"
|
||||
echo " Godot路径: $GODOT_PATH"
|
||||
echo " 导出预设: $EXPORT_PRESET"
|
||||
echo " 输出目录: $BUILD_DIR"
|
||||
echo
|
||||
|
||||
# 创建构建目录结构
|
||||
echo -e "${BLUE}[构建]${NC} 准备构建环境..."
|
||||
mkdir -p "$BUILD_DIR"
|
||||
mkdir -p "scripts"
|
||||
|
||||
# 备份旧版本（如果存在）
|
||||
if [ -f "$BUILD_DIR/index.html" ]; then
|
||||
echo -e "${YELLOW}[备份]${NC} 备份旧版本..."
|
||||
BACKUP_DIR="build/backup/$(date +%Y%m%d_%H%M%S)"
|
||||
mkdir -p "$BACKUP_DIR"
|
||||
cp -r "$BUILD_DIR"/* "$BACKUP_DIR/" 2>/dev/null
|
||||
echo " 备份位置: $BACKUP_DIR/"
|
||||
fi
|
||||
|
||||
# 清理旧文件
|
||||
echo -e "${BLUE}[清理]${NC} 清理旧的导出文件..."
|
||||
rm -f "$BUILD_DIR"/*
|
||||
|
||||
# 检查导出预设
|
||||
echo -e "${BLUE}[验证]${NC} 检查导出预设..."
|
||||
"$GODOT_PATH" --headless --export-debug "$EXPORT_PRESET" --check-only >/dev/null 2>&1
|
||||
if [ $? -ne 0 ]; then
|
||||
echo -e "${RED}[错误]${NC} 导出预设 \"$EXPORT_PRESET\" 不存在或配置错误！"
|
||||
echo "请在Godot编辑器中创建Web导出预设"
|
||||
echo
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# 导出项目
|
||||
echo -e "${GREEN}[导出]${NC} 开始导出Web版本..."
|
||||
echo " 目标文件: $BUILD_DIR/index.html"
|
||||
echo " 请稍候..."
|
||||
echo
|
||||
|
||||
"$GODOT_PATH" --headless --export-release "$EXPORT_PRESET" "$BUILD_DIR/index.html"
|
||||
|
||||
if [ $? -ne 0 ]; then
|
||||
echo -e "${RED}[失败]${NC} 导出失败！"
|
||||
echo
|
||||
echo "可能的原因:"
|
||||
echo "1. 导出模板未安装"
|
||||
echo "2. 项目配置错误"
|
||||
echo "3. 资源文件损坏"
|
||||
echo
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# 验证导出文件
|
||||
echo -e "${BLUE}[验证]${NC} 验证导出文件..."
|
||||
REQUIRED_FILES="index.html index.js index.wasm index.pck"
|
||||
MISSING_FILES=""
|
||||
|
||||
for file in $REQUIRED_FILES; do
|
||||
if [ ! -f "$BUILD_DIR/$file" ]; then
|
||||
MISSING_FILES="$MISSING_FILES $file"
|
||||
fi
|
||||
done
|
||||
|
||||
if [ -n "$MISSING_FILES" ]; then
|
||||
echo -e "${RED}[错误]${NC} 缺少必要文件:$MISSING_FILES"
|
||||
echo "导出可能不完整，请检查Godot配置"
|
||||
echo
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# 复制额外资源
|
||||
echo -e "${BLUE}[复制]${NC} 复制额外资源..."
|
||||
[ -f "assets/web/favicon.ico" ] && cp "assets/web/favicon.ico" "$BUILD_DIR/"
|
||||
[ -f "assets/web/manifest.json" ] && cp "assets/web/manifest.json" "$BUILD_DIR/"
|
||||
[ -f "assets/web/service-worker.js" ] && cp "assets/web/service-worker.js" "$BUILD_DIR/"
|
||||
[ -f "assets/web/custom_shell.html" ] && cp "assets/web/custom_shell.html" "$BUILD_DIR/"
|
||||
|
||||
# 生成部署信息
|
||||
echo -e "${BLUE}[生成]${NC} 生成部署信息..."
|
||||
cat > "$BUILD_DIR/deploy_info.json" << EOF
|
||||
{
|
||||
"project": "$PROJECT_NAME",
|
||||
"version": "$VERSION",
|
||||
"build_time": "$(date)",
|
||||
"platform": "web",
|
||||
"godot_version": "4.5",
|
||||
"export_preset": "$EXPORT_PRESET",
|
||||
"build_machine": "$(hostname)",
|
||||
"build_user": "$(whoami)",
|
||||
"build_os": "$(uname -s)"
|
||||
}
|
||||
EOF
|
||||
|
||||
# 生成.htaccess文件
|
||||
echo -e "${BLUE}[配置]${NC} 生成Apache配置文件..."
|
||||
cat > "$BUILD_DIR/.htaccess" << 'EOF'
|
||||
# 鲸鱼镇 Web版本 Apache配置
|
||||
# 自动生成
|
||||
|
||||
# MIME类型配置
|
||||
AddType application/wasm .wasm
|
||||
AddType application/octet-stream .pck
|
||||
AddType application/javascript .js
|
||||
|
||||
# 启用压缩
|
||||
<IfModule mod_deflate.c>
|
||||
AddOutputFilterByType DEFLATE text/html text/css application/javascript application/wasm
|
||||
AddOutputFilterByType DEFLATE application/json application/xml
|
||||
</IfModule>
|
||||
|
||||
# 缓存控制
|
||||
<IfModule mod_expires.c>
|
||||
ExpiresActive On
|
||||
ExpiresByType application/wasm "access plus 1 month"
|
||||
ExpiresByType application/octet-stream "access plus 1 month"
|
||||
ExpiresByType application/javascript "access plus 1 week"
|
||||
ExpiresByType text/html "access plus 1 hour"
|
||||
</IfModule>
|
||||
|
||||
# CORS配置
|
||||
<IfModule mod_headers.c>
|
||||
Header set Access-Control-Allow-Origin "*"
|
||||
Header set Access-Control-Allow-Methods "GET, POST, PUT, DELETE, OPTIONS"
|
||||
Header set Access-Control-Allow-Headers "Content-Type, Authorization"
|
||||
Header set Cross-Origin-Embedder-Policy "require-corp"
|
||||
Header set Cross-Origin-Opener-Policy "same-origin"
|
||||
</IfModule>
|
||||
EOF
|
||||
|
||||
# 计算文件大小
|
||||
echo -e "${BLUE}[统计]${NC} 计算文件大小..."
|
||||
TOTAL_SIZE=$(du -sb "$BUILD_DIR" | cut -f1)
|
||||
TOTAL_MB=$((TOTAL_SIZE / 1024 / 1024))
|
||||
|
||||
# 显示构建结果
|
||||
echo
|
||||
echo "========================================"
|
||||
echo -e "${GREEN} 导出成功！${NC}"
|
||||
echo "========================================"
|
||||
echo
|
||||
echo -e "${GREEN}[完成]${NC} 构建统计:"
|
||||
echo " 导出位置: $BUILD_DIR/"
|
||||
echo " 总文件大小: ${TOTAL_MB} MB"
|
||||
echo " 构建时间: $(date)"
|
||||
echo
|
||||
|
||||
echo -e "${BLUE}[文件]${NC} 导出文件列表:"
|
||||
for file in "$BUILD_DIR"/*; do
|
||||
if [ -f "$file" ]; then
|
||||
filename=$(basename "$file")
|
||||
size=$(stat -f%z "$file" 2>/dev/null || stat -c%s "$file" 2>/dev/null)
|
||||
size_mb=$((size / 1024 / 1024))
|
||||
if [ $size_mb -gt 0 ]; then
|
||||
echo " $filename: ${size_mb} MB"
|
||||
else
|
||||
size_kb=$((size / 1024))
|
||||
echo " $filename: ${size_kb} KB"
|
||||
fi
|
||||
fi
|
||||
done
|
||||
|
||||
echo
|
||||
echo -e "${YELLOW}[下一步]${NC} 部署选项:"
|
||||
echo " 1. 本地测试: ./scripts/serve_web.sh"
|
||||
echo " 2. 上传到服务器: 将 $BUILD_DIR/ 目录上传"
|
||||
echo " 3. 查看文档: docs/web_deployment_guide.md"
|
||||
echo
|
||||
|
||||
echo -e "${GREEN}[提示]${NC} 部署前请确保:"
|
||||
echo " - 服务器支持WASM MIME类型"
|
||||
echo " - 配置了正确的CORS头"
|
||||
echo " - 启用了文件压缩"
|
||||
echo
|
||||
|
||||
# 询问是否启动本地服务器
|
||||
echo -n "是否启动本地测试服务器？(y/N): "
|
||||
read -r START_SERVER
|
||||
if [[ $START_SERVER =~ ^[Yy]$ ]]; then
|
||||
echo
|
||||
echo -e "${GREEN}[启动]${NC} 启动本地服务器..."
|
||||
./scripts/serve_web.sh
|
||||
else
|
||||
echo
|
||||
echo "构建完成！可以手动运行 ./scripts/serve_web.sh 进行测试"
|
||||
fi
|
||||
173
tools/serve_web.bat
Normal file
173
tools/serve_web.bat
Normal file
@@ -0,0 +1,173 @@
|
||||
@echo off
|
||||
setlocal enabledelayedexpansion
|
||||
|
||||
echo ========================================
|
||||
echo 鲸鱼镇 本地Web服务器 v1.0
|
||||
echo ========================================
|
||||
echo.
|
||||
|
||||
REM 配置变量
|
||||
set "BUILD_DIR=build\web"
|
||||
set "PORT=8000"
|
||||
set "FALLBACK_PORT=8080"
|
||||
|
||||
REM 颜色代码
|
||||
set "RED=[91m"
|
||||
set "GREEN=[92m"
|
||||
set "YELLOW=[93m"
|
||||
set "BLUE=[94m"
|
||||
set "RESET=[0m"
|
||||
|
||||
REM 检查导出文件
|
||||
echo %BLUE%[检查]%RESET% 验证Web导出文件...
|
||||
if not exist "%BUILD_DIR%\index.html" (
|
||||
echo %RED%[错误]%RESET% 未找到Web导出文件！
|
||||
echo.
|
||||
echo 请先运行以下命令导出项目:
|
||||
echo scripts\build_web.bat
|
||||
echo.
|
||||
echo 或在Godot编辑器中导出Web版本到: %BUILD_DIR%\
|
||||
echo.
|
||||
pause
|
||||
exit /b 1
|
||||
)
|
||||
|
||||
REM 检查必要文件
|
||||
echo %BLUE%[验证]%RESET% 检查必要文件...
|
||||
set "REQUIRED_FILES=index.html index.js index.wasm index.pck"
|
||||
set "MISSING_FILES="
|
||||
|
||||
for %%f in (%REQUIRED_FILES%) do (
|
||||
if not exist "%BUILD_DIR%\%%f" (
|
||||
set "MISSING_FILES=!MISSING_FILES! %%f"
|
||||
)
|
||||
)
|
||||
|
||||
if not "!MISSING_FILES!"=="" (
|
||||
echo %RED%[错误]%RESET% 缺少必要文件:!MISSING_FILES!
|
||||
echo 请重新导出项目
|
||||
echo.
|
||||
pause
|
||||
exit /b 1
|
||||
)
|
||||
|
||||
REM 检查Python
|
||||
echo %BLUE%[检查]%RESET% 验证Python环境...
|
||||
python --version >nul 2>&1
|
||||
if %ERRORLEVEL% neq 0 (
|
||||
echo %RED%[错误]%RESET% 未找到Python！
|
||||
echo.
|
||||
echo 请安装Python 3.x:
|
||||
echo 下载地址: https://python.org/downloads
|
||||
echo 或使用包管理器: winget install Python.Python.3
|
||||
echo.
|
||||
echo 安装后请重启命令提示符
|
||||
echo.
|
||||
pause
|
||||
exit /b 1
|
||||
)
|
||||
|
||||
REM 获取Python版本
|
||||
for /f "tokens=2" %%i in ('python --version 2^>^&1') do set "PYTHON_VERSION=%%i"
|
||||
echo %GREEN%[信息]%RESET% Python版本: %PYTHON_VERSION%
|
||||
|
||||
REM 显示文件信息
|
||||
echo.
|
||||
echo %GREEN%[信息]%RESET% Web文件统计:
|
||||
set "TOTAL_SIZE=0"
|
||||
for %%f in ("%BUILD_DIR%\*") do (
|
||||
set "size=%%~zf"
|
||||
set /a "TOTAL_SIZE+=size"
|
||||
set /a "size_mb=size/1024/1024"
|
||||
if !size_mb! gtr 0 (
|
||||
echo %%~nxf: !size_mb! MB
|
||||
) else (
|
||||
set /a "size_kb=size/1024"
|
||||
echo %%~nxf: !size_kb! KB
|
||||
)
|
||||
)
|
||||
set /a "TOTAL_MB=TOTAL_SIZE/1024/1024"
|
||||
echo 总大小: %TOTAL_MB% MB
|
||||
|
||||
REM 检查端口占用
|
||||
echo.
|
||||
echo %BLUE%[网络]%RESET% 检查端口占用...
|
||||
netstat -an | find ":%PORT%" >nul 2>&1
|
||||
if %ERRORLEVEL% equ 0 (
|
||||
echo %YELLOW%[警告]%RESET% 端口 %PORT% 已被占用，尝试使用 %FALLBACK_PORT%
|
||||
set "PORT=%FALLBACK_PORT%"
|
||||
|
||||
netstat -an | find ":%PORT%" >nul 2>&1
|
||||
if %ERRORLEVEL% equ 0 (
|
||||
echo %RED%[错误]%RESET% 端口 %PORT% 也被占用！
|
||||
echo 请手动指定端口: python -m http.server [端口号]
|
||||
echo.
|
||||
pause
|
||||
exit /b 1
|
||||
)
|
||||
)
|
||||
|
||||
REM 获取本机IP地址
|
||||
for /f "tokens=2 delims=:" %%i in ('ipconfig ^| find "IPv4"') do (
|
||||
set "LOCAL_IP=%%i"
|
||||
set "LOCAL_IP=!LOCAL_IP: =!"
|
||||
goto :ip_found
|
||||
)
|
||||
:ip_found
|
||||
|
||||
REM 显示启动信息
|
||||
echo.
|
||||
echo %GREEN%[启动]%RESET% 启动HTTP服务器...
|
||||
echo 端口: %PORT%
|
||||
echo 目录: %BUILD_DIR%
|
||||
echo Python: %PYTHON_VERSION%
|
||||
echo.
|
||||
echo ========================================
|
||||
echo %GREEN% 访问地址%RESET%
|
||||
echo ========================================
|
||||
echo 本地访问: http://localhost:%PORT%
|
||||
echo 局域网访问: http://!LOCAL_IP!:%PORT%
|
||||
echo.
|
||||
echo %YELLOW%[控制]%RESET% 服务器控制:
|
||||
echo 停止服务器: Ctrl+C
|
||||
echo 重启服务器: 关闭后重新运行脚本
|
||||
echo.
|
||||
echo %BLUE%[调试]%RESET% 调试工具:
|
||||
echo 开发者工具: F12
|
||||
echo 控制台日志: 查看浏览器Console
|
||||
echo 网络请求: 查看Network标签
|
||||
echo.
|
||||
echo ========================================
|
||||
|
||||
REM 尝试自动打开浏览器
|
||||
echo %BLUE%[浏览器]%RESET% 尝试打开默认浏览器...
|
||||
start http://localhost:%PORT% >nul 2>&1
|
||||
if %ERRORLEVEL% neq 0 (
|
||||
echo %YELLOW%[提示]%RESET% 无法自动打开浏览器，请手动访问上述地址
|
||||
)
|
||||
|
||||
echo.
|
||||
echo %GREEN%[就绪]%RESET% 服务器启动中...
|
||||
echo.
|
||||
|
||||
REM 切换到构建目录并启动服务器
|
||||
cd "%BUILD_DIR%"
|
||||
|
||||
REM 创建简单的服务器日志
|
||||
echo [%date% %time%] 服务器启动 - 端口:%PORT% >> server.log
|
||||
|
||||
REM 启动Python HTTP服务器
|
||||
python -m http.server %PORT%
|
||||
|
||||
REM 服务器停止后的清理
|
||||
echo.
|
||||
echo %YELLOW%[停止]%RESET% 服务器已停止
|
||||
echo [%date% %time%] 服务器停止 >> server.log
|
||||
|
||||
REM 返回原目录
|
||||
cd ..\..
|
||||
|
||||
echo.
|
||||
echo %GREEN%[完成]%RESET% 感谢使用鲸鱼镇Web服务器！
|
||||
echo.
|
||||
pause
|
||||
188
tools/serve_web.sh
Normal file
188
tools/serve_web.sh
Normal file
@@ -0,0 +1,188 @@
|
||||
#!/bin/bash
|
||||
|
||||
# 鲸鱼镇 本地Web服务器 (Linux/macOS)
|
||||
# 版本: 1.0.0
|
||||
|
||||
# 颜色定义
|
||||
RED='\033[0;31m'
|
||||
GREEN='\033[0;32m'
|
||||
YELLOW='\033[1;33m'
|
||||
BLUE='\033[0;34m'
|
||||
NC='\033[0m' # No Color
|
||||
|
||||
# 配置变量
|
||||
BUILD_DIR="build/web"
|
||||
PORT=8000
|
||||
FALLBACK_PORT=8080
|
||||
|
||||
echo "========================================"
|
||||
echo " 鲸鱼镇 本地Web服务器 v1.0"
|
||||
echo "========================================"
|
||||
echo
|
||||
|
||||
# 检查导出文件
|
||||
echo -e "${BLUE}[检查]${NC} 验证Web导出文件..."
|
||||
if [ ! -f "$BUILD_DIR/index.html" ]; then
|
||||
echo -e "${RED}[错误]${NC} 未找到Web导出文件！"
|
||||
echo
|
||||
echo "请先运行以下命令导出项目:"
|
||||
echo " ./scripts/build_web.sh"
|
||||
echo
|
||||
echo "或在Godot编辑器中导出Web版本到: $BUILD_DIR/"
|
||||
echo
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# 检查必要文件
|
||||
echo -e "${BLUE}[验证]${NC} 检查必要文件..."
|
||||
REQUIRED_FILES="index.html index.js index.wasm index.pck"
|
||||
MISSING_FILES=""
|
||||
|
||||
for file in $REQUIRED_FILES; do
|
||||
if [ ! -f "$BUILD_DIR/$file" ]; then
|
||||
MISSING_FILES="$MISSING_FILES $file"
|
||||
fi
|
||||
done
|
||||
|
||||
if [ -n "$MISSING_FILES" ]; then
|
||||
echo -e "${RED}[错误]${NC} 缺少必要文件:$MISSING_FILES"
|
||||
echo "请重新导出项目"
|
||||
echo
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# 检查Python
|
||||
echo -e "${BLUE}[检查]${NC} 验证Python环境..."
|
||||
if ! command -v python3 &> /dev/null && ! command -v python &> /dev/null; then
|
||||
echo -e "${RED}[错误]${NC} 未找到Python！"
|
||||
echo
|
||||
echo "请安装Python 3.x:"
|
||||
echo " macOS: brew install python"
|
||||
echo " Ubuntu: sudo apt install python3"
|
||||
echo " 或访问: https://python.org/downloads"
|
||||
echo
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# 确定Python命令
|
||||
PYTHON_CMD="python3"
|
||||
if ! command -v python3 &> /dev/null; then
|
||||
PYTHON_CMD="python"
|
||||
fi
|
||||
|
||||
# 获取Python版本
|
||||
PYTHON_VERSION=$($PYTHON_CMD --version 2>&1 | cut -d' ' -f2)
|
||||
echo -e "${GREEN}[信息]${NC} Python版本: $PYTHON_VERSION"
|
||||
|
||||
# 显示文件信息
|
||||
echo
|
||||
echo -e "${GREEN}[信息]${NC} Web文件统计:"
|
||||
TOTAL_SIZE=$(du -sb "$BUILD_DIR" | cut -f1)
|
||||
TOTAL_MB=$((TOTAL_SIZE / 1024 / 1024))
|
||||
|
||||
for file in "$BUILD_DIR"/*; do
|
||||
if [ -f "$file" ]; then
|
||||
filename=$(basename "$file")
|
||||
size=$(stat -f%z "$file" 2>/dev/null || stat -c%s "$file" 2>/dev/null)
|
||||
size_mb=$((size / 1024 / 1024))
|
||||
if [ $size_mb -gt 0 ]; then
|
||||
echo " $filename: ${size_mb} MB"
|
||||
else
|
||||
size_kb=$((size / 1024))
|
||||
echo " $filename: ${size_kb} KB"
|
||||
fi
|
||||
fi
|
||||
done
|
||||
echo " 总大小: ${TOTAL_MB} MB"
|
||||
|
||||
# 检查端口占用
|
||||
echo
|
||||
echo -e "${BLUE}[网络]${NC} 检查端口占用..."
|
||||
if lsof -Pi :$PORT -sTCP:LISTEN -t >/dev/null 2>&1; then
|
||||
echo -e "${YELLOW}[警告]${NC} 端口 $PORT 已被占用，尝试使用 $FALLBACK_PORT"
|
||||
PORT=$FALLBACK_PORT
|
||||
|
||||
if lsof -Pi :$PORT -sTCP:LISTEN -t >/dev/null 2>&1; then
|
||||
echo -e "${RED}[错误]${NC} 端口 $PORT 也被占用！"
|
||||
echo "请手动指定端口: $PYTHON_CMD -m http.server [端口号]"
|
||||
echo
|
||||
exit 1
|
||||
fi
|
||||
fi
|
||||
|
||||
# 获取本机IP地址
|
||||
LOCAL_IP=$(ifconfig | grep -Eo 'inet (addr:)?([0-9]*\.){3}[0-9]*' | grep -Eo '([0-9]*\.){3}[0-9]*' | grep -v '127.0.0.1' | head -1)
|
||||
if [ -z "$LOCAL_IP" ]; then
|
||||
LOCAL_IP=$(hostname -I | cut -d' ' -f1 2>/dev/null)
|
||||
fi
|
||||
if [ -z "$LOCAL_IP" ]; then
|
||||
LOCAL_IP="localhost"
|
||||
fi
|
||||
|
||||
# 显示启动信息
|
||||
echo
|
||||
echo -e "${GREEN}[启动]${NC} 启动HTTP服务器..."
|
||||
echo " 端口: $PORT"
|
||||
echo " 目录: $BUILD_DIR"
|
||||
echo " Python: $PYTHON_VERSION"
|
||||
echo
|
||||
|
||||
echo "========================================"
|
||||
echo -e "${GREEN} 访问地址${NC}"
|
||||
echo "========================================"
|
||||
echo " 本地访问: http://localhost:$PORT"
|
||||
echo " 局域网访问: http://$LOCAL_IP:$PORT"
|
||||
echo
|
||||
|
||||
echo -e "${YELLOW}[控制]${NC} 服务器控制:"
|
||||
echo " 停止服务器: Ctrl+C"
|
||||
echo " 重启服务器: 关闭后重新运行脚本"
|
||||
echo
|
||||
|
||||
echo -e "${BLUE}[调试]${NC} 调试工具:"
|
||||
echo " 开发者工具: F12"
|
||||
echo " 控制台日志: 查看浏览器Console"
|
||||
echo " 网络请求: 查看Network标签"
|
||||
echo
|
||||
|
||||
echo "========================================"
|
||||
|
||||
# 尝试自动打开浏览器
|
||||
echo -e "${BLUE}[浏览器]${NC} 尝试打开默认浏览器..."
|
||||
if command -v open &> /dev/null; then
|
||||
# macOS
|
||||
open "http://localhost:$PORT" 2>/dev/null
|
||||
elif command -v xdg-open &> /dev/null; then
|
||||
# Linux
|
||||
xdg-open "http://localhost:$PORT" 2>/dev/null
|
||||
else
|
||||
echo -e "${YELLOW}[提示]${NC} 无法自动打开浏览器，请手动访问上述地址"
|
||||
fi
|
||||
|
||||
echo
|
||||
echo -e "${GREEN}[就绪]${NC} 服务器启动中..."
|
||||
echo
|
||||
|
||||
# 切换到构建目录并启动服务器
|
||||
cd "$BUILD_DIR"
|
||||
|
||||
# 创建简单的服务器日志
|
||||
echo "[$(date)] 服务器启动 - 端口:$PORT" >> server.log
|
||||
|
||||
# 设置信号处理
|
||||
trap 'echo -e "\n${YELLOW}[停止]${NC} 服务器已停止"; echo "[$(date)] 服务器停止" >> server.log; exit 0' INT
|
||||
|
||||
# 启动Python HTTP服务器
|
||||
$PYTHON_CMD -m http.server $PORT
|
||||
|
||||
# 服务器停止后的清理
|
||||
echo
|
||||
echo -e "${YELLOW}[停止]${NC} 服务器已停止"
|
||||
echo "[$(date)] 服务器停止" >> server.log
|
||||
|
||||
# 返回原目录
|
||||
cd ../..
|
||||
|
||||
echo
|
||||
echo -e "${GREEN}[完成]${NC} 感谢使用鲸鱼镇Web服务器！"
|
||||
echo
|
||||
Reference in New Issue
Block a user