|
|
|
|
|
# Tetris Game 构建系统
|
|
|
|
|
|
|
|
|
|
|
|
这是一个统一的构建系统，支持 Windows、macOS 和 Linux 平台的应用打包，所有分发文件统一存放在 `dist/` 目录中。
|
|
|
|
|
|
|
|
|
|
|
|
## 🚀 快速开始
|
|
|
|
|
|
|
|
|
|
|
|
### 构建所有平台
|
|
|
|
|
|
```bash
|
|
|
|
|
|
make all
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
### 构建特定平台
|
|
|
|
|
|
```bash
|
|
|
|
|
|
make windows # 构建 Windows 版本
|
|
|
|
|
|
make macos # 构建 macOS 版本
|
|
|
|
|
|
make linux # 构建 Linux 版本
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
### 查看帮助
|
|
|
|
|
|
```bash
|
|
|
|
|
|
make help
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
## 📁 目录结构
|
|
|
|
|
|
|
|
|
|
|
|
构建完成后，`dist/` 目录结构如下：
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
dist/
|
|
|
|
|
|
├── TetrisGame-Windows-v1.0.zip # Windows 分发包
|
|
|
|
|
|
├── TetrisGame-macOS-v1.0.dmg # macOS 分发包
|
|
|
|
|
|
├── TetrisGame-Linux-v1.0.tar.gz # Linux 分发包
|
|
|
|
|
|
├── windows/ # Windows 构建临时目录
|
|
|
|
|
|
├── macos/ # macOS 构建临时目录
|
|
|
|
|
|
└── linux/ # Linux 构建临时目录
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
## 🛠️ 可用命令
|
|
|
|
|
|
|
|
|
|
|
|
### 基础命令
|
|
|
|
|
|
- `make help` - 显示帮助信息
|
|
|
|
|
|
- `make info` - 显示构建信息
|
|
|
|
|
|
- `make check-env` - 检查构建环境
|
|
|
|
|
|
- `make clean` - 清理所有构建文件
|
|
|
|
|
|
|
|
|
|
|
|
### 构建命令
|
|
|
|
|
|
- `make windows` - 构建 Windows 版本
|
|
|
|
|
|
- `make macos` - 构建 macOS 版本
|
|
|
|
|
|
- `make linux` - 构建 Linux 版本
|
|
|
|
|
|
- `make all` - 构建所有平台版本
|
|
|
|
|
|
|
|
|
|
|
|
### 验证命令
|
|
|
|
|
|
- `make verify` - 验证构建结果
|
|
|
|
|
|
- `make run` - 运行游戏（开发模式）
|
|
|
|
|
|
- `make test` - 运行测试
|
|
|
|
|
|
|
|
|
|
|
|
### 依赖管理
|
|
|
|
|
|
- `make deps` - 下载依赖
|
|
|
|
|
|
|
|
|
|
|
|
### 迁移命令
|
|
|
|
|
|
- `make migrate` - 迁移旧版本文件到 dist 目录
|
|
|
|
|
|
|
|
|
|
|
|
## 📦 分发包内容
|
|
|
|
|
|
|
|
|
|
|
|
### Windows 版本 (TetrisGame-Windows-v1.0.zip)
|
|
|
|
|
|
```
|
|
|
|
|
|
TetrisGame-Windows-v1.0/
|
|
|
|
|
|
├── TetrisGame.exe # 主程序
|
|
|
|
|
|
├── 启动游戏.bat # 中文启动脚本
|
|
|
|
|
|
├── README.txt # 英文说明
|
|
|
|
|
|
├── 安装说明.txt # 中文说明
|
|
|
|
|
|
└── assets/ # 资源文件
|
|
|
|
|
|
└── fonts/ # 字体文件
|
|
|
|
|
|
├── HYSongYunLangHeiW-1.ttf
|
|
|
|
|
|
└── README.md
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
### macOS 版本 (TetrisGame-macOS-v1.0.dmg)
|
|
|
|
|
|
- 包含完整的 TetrisGame.app 应用包
|
|
|
|
|
|
- 支持拖拽到 Applications 文件夹安装
|
|
|
|
|
|
- 包含应用图标和中文显示名称
|
|
|
|
|
|
|
|
|
|
|
|
### Linux 版本 (TetrisGame-Linux-v1.0.tar.gz)
|
|
|
|
|
|
```
|
|
|
|
|
|
TetrisGame-Linux-v1.0/
|
|
|
|
|
|
├── tetris # 主程序
|
|
|
|
|
|
├── start_game.sh # 启动脚本
|
|
|
|
|
|
├── README.txt # 说明文档
|
|
|
|
|
|
└── assets/ # 资源文件
|
|
|
|
|
|
└── fonts/ # 字体文件
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
## 🔧 系统要求
|
|
|
|
|
|
|
|
|
|
|
|
### 构建环境
|
|
|
|
|
|
- Go 1.19 或更高版本
|
|
|
|
|
|
- macOS (用于构建 macOS 版本的 DMG)
|
|
|
|
|
|
- zip 命令 (用于创建 Windows 压缩包)
|
|
|
|
|
|
- tar 命令 (用于创建 Linux 压缩包)
|
|
|
|
|
|
|
|
|
|
|
|
### 运行环境
|
|
|
|
|
|
- **Windows**: Windows 10/11 (64-bit)
|
|
|
|
|
|
- **macOS**: macOS 10.15 或更高版本
|
|
|
|
|
|
- **Linux**: 64-bit Linux 发行版，支持 X11 或 Wayland
|
|
|
|
|
|
|
|
|
|
|
|
## 🎮 游戏控制
|
|
|
|
|
|
|
|
|
|
|
|
- **←→** 方向键：左右移动方块
|
|
|
|
|
|
- **↑** 方向键：旋转方块
|
|
|
|
|
|
- **↓** 方向键：快速下降
|
|
|
|
|
|
- **空格键**：瞬间下降到底部
|
|
|
|
|
|
- **L 键**：切换中英文界面
|
|
|
|
|
|
- **R 键**：游戏结束后重新开始
|
|
|
|
|
|
|
|
|
|
|
|
## 🌍 多语言支持
|
|
|
|
|
|
|
|
|
|
|
|
游戏支持中英文双语界面，按 L 键可以实时切换语言。
|
|
|
|
|
|
|
|
|
|
|
|
## 📝 版本信息
|
|
|
|
|
|
|
|
|
|
|
|
- **版本**: v1.0
|
|
|
|
|
|
- **构建时间**: 自动生成
|
|
|
|
|
|
- **Git 提交**: 自动检测
|
|
|
|
|
|
|
|
|
|
|
|
## 🔍 故障排除
|
|
|
|
|
|
|
|
|
|
|
|
### 构建失败
|
|
|
|
|
|
1. 检查 Go 环境：`go version`
|
|
|
|
|
|
2. 检查依赖：`make deps`
|
|
|
|
|
|
3. 清理重建：`make clean && make all`
|
|
|
|
|
|
|
|
|
|
|
|
### 字体问题
|
|
|
|
|
|
- 确保 `assets/fonts/` 目录存在
|
|
|
|
|
|
- 确保字体文件 `HYSongYunLangHeiW-1.ttf` 存在
|
|
|
|
|
|
|
|
|
|
|
|
### macOS DMG 创建失败
|
|
|
|
|
|
- 确保在 macOS 系统上运行
|
|
|
|
|
|
- 确保有足够的磁盘空间
|
|
|
|
|
|
- 检查 hdiutil 命令是否可用
|
|
|
|
|
|
|
|
|
|
|
|
## 📄 许可证
|
|
|
|
|
|
|
|
|
|
|
|
© 2025 Tetris Game. All rights reserved.
|
