Skip to content

TESTING.md

Latest commit

 

History

History
394 lines (272 loc) · 7.64 KB

TESTING.md

File metadata and controls

394 lines (272 loc) · 7.64 KB

打包测试指南 (Package Testing Guide)

本文档提供打包程序的测试流程和检查清单。

This document provides testing procedures and checklists for the packaged application.

📋 测试前准备 (Pre-Testing Setup)

1. 构建程序 (Build the Application)

# Windows
build.bat

# Linux/Mac
./build.sh

2. 确认构建成功 (Verify Build Success)

检查以下文件是否存在：

  • ✅ dist/CircuitRepairGame/CircuitRepairGame.exe (Windows)
  • ✅ dist/CircuitRepairGame/CircuitRepairGame (Linux/Mac)
  • ✅ dist/CircuitRepairGame/assets/ 目录
  • ✅ dist/CircuitRepairGame/data/ 目录

🧪 功能测试 (Functional Testing)

测试 1: 程序启动 (Application Launch)

目标: 验证程序能够正常启动

步骤:

  1. 双击可执行文件
  2. 观察启动时间（应 < 5秒）
  3. 检查是否显示主菜单

预期结果:

  • ✅ 程序成功启动
  • ✅ 无错误提示
  • ✅ 主菜单正常显示
  • ✅ 窗口大小正确（800x600）

实际结果: _____________

测试 2: 主菜单功能 (Main Menu)

目标: 验证主菜单所有功能正常

步骤:

  1. 检查难度选择按钮（简单/普通/困难/地狱）
  2. 点击"新游戏"按钮
  3. 返回主菜单，点击"继续游戏"按钮
  4. 检查进度显示（关卡数/星数）

预期结果:

  • ✅ 所有按钮可点击
  • ✅ 难度选择正常切换
  • ✅ 新游戏从关卡1开始
  • ✅ 继续游戏跳转到当前关卡
  • ✅ 进度显示正确

实际结果: _____________

测试 3: 游戏玩法 (Gameplay)

目标: 验证核心游戏逻辑正常

步骤:

  1. 开始新游戏（简单难度）
  2. 点击黑色方块旋转元件
  3. 完成电路连接
  4. 观察胜利动画和结算界面

预期结果:

  • ✅ 元件旋转正常（90°顺时针）
  • ✅ 电路连通性检测正确
  • ✅ 倒计时正常工作
  • ✅ 移动次数统计正确
  • ✅ 胜利判定正确
  • ✅ 粒子特效显示正常

实际结果: _____________

测试 4: 结算场景 (Result Scene)

目标: 验证结算界面和进度保存

步骤:

  1. 完成一个关卡
  2. 检查星级评分
  3. 检查统计信息（用时、移动次数）
  4. 点击"下一关"按钮
  5. 点击"重试"按钮
  6. 点击"主菜单"按钮

预期结果:

  • ✅ 星级评分正确（1-3星）
  • ✅ 统计信息准确
  • ✅ 新纪录提示正常
  • ✅ 关卡解锁提示正常
  • ✅ 所有按钮功能正常
  • ✅ 进度自动保存

实际结果: _____________

测试 5: 进度系统 (Progress System)

目标: 验证进度保存和加载

步骤:

  1. 完成几个关卡
  2. 关闭程序
  3. 重新启动程序
  4. 检查主菜单进度显示
  5. 点击"继续游戏"

预期结果:

  • ✅ 进度正确保存
  • ✅ 重启后进度正确加载
  • ✅ 已完成关卡数正确
  • ✅ 总星数正确
  • ✅ 继续游戏跳转到正确关卡

实际结果: _____________

测试 6: 暂停功能 (Pause Function)

目标: 验证暂停和恢复功能

步骤:

  1. 开始游戏
  2. 按 ESC 键暂停
  3. 检查暂停菜单
  4. 点击"继续"恢复游戏
  5. 点击"重新开始"
  6. 点击"返回主菜单"

预期结果:

  • ✅ ESC 键暂停正常
  • ✅ 暂停时游戏停止
  • ✅ 暂停菜单显示正常
  • ✅ 所有按钮功能正常

实际结果: _____________

测试 7: 调试功能 (Debug Features)

目标: 验证调试信息显示

步骤:

  1. 开始游戏
  2. 按 F3 键显示调试信息
  3. 再按 F3 键隐藏调试信息

预期结果:

  • ✅ F3 键切换正常
  • ✅ 调试信息显示正确（FPS、内存等）
  • ✅ 不影响游戏性能

实际结果: _____________

⚡ 性能测试 (Performance Testing)

测试 8: 启动性能 (Startup Performance)

测试项:

  • 启动时间: _______ 秒（目标 < 5秒）
  • 内存占用: _______ MB（目标 < 200MB）
  • CPU 占用: _______ %（目标 < 10%）

预期结果:

  • ✅ 启动时间 < 5秒
  • ✅ 内存占用合理
  • ✅ CPU 占用低

实际结果: _____________

测试 9: 运行性能 (Runtime Performance)

测试项:

  • 游戏帧率: _______ FPS（目标 60 FPS）
  • 内存占用: _______ MB（目标 < 300MB）
  • CPU 占用: _______ %（目标 < 30%）

预期结果:

  • ✅ 稳定 60 FPS
  • ✅ 无卡顿现象
  • ✅ 内存无泄漏

实际结果: _____________

测试 10: 长时间运行 (Long-Running Test)

步骤:

  1. 连续游玩 30 分钟
  2. 监控内存和 CPU 占用
  3. 检查是否有性能下降

预期结果:

  • ✅ 无内存泄漏
  • ✅ 性能稳定
  • ✅ 无崩溃

实际结果: _____________

🔧 兼容性测试 (Compatibility Testing)

测试 11: 操作系统兼容性 (OS Compatibility)

Windows:

  • Windows 10 (64-bit)
  • Windows 11 (64-bit)
  • Windows 10 (32-bit)

Linux:

  • Ubuntu 20.04+
  • Debian 11+
  • Fedora 35+

Mac:

  • macOS 11 (Big Sur)+
  • macOS 12 (Monterey)+
  • macOS 13 (Ventura)+

实际结果: _____________

测试 12: 分辨率兼容性 (Resolution Compatibility)

测试分辨率:

  • 1920x1080 (Full HD)
  • 1366x768 (HD)
  • 2560x1440 (2K)
  • 3840x2160 (4K)

预期结果:

  • ✅ 所有分辨率正常显示
  • ✅ UI 元素不变形
  • ✅ 文字清晰可读

实际结果: _____________

🛡️ 稳定性测试 (Stability Testing)

测试 13: 异常处理 (Error Handling)

测试场景:

  1. 删除 data/config/ 目录后启动
  2. 删除 assets/ 目录后启动
  3. 存档文件损坏后启动
  4. 快速连续点击按钮

预期结果:

  • ✅ 有友好的错误提示
  • ✅ 不会崩溃
  • ✅ 能够恢复或重置

实际结果: _____________

测试 14: 边界条件 (Edge Cases)

测试场景:

  1. 倒计时归零时完成关卡
  2. 移动次数达到极大值
  3. 快速旋转同一元件
  4. 快速切换场景

预期结果:

  • ✅ 所有边界条件正确处理
  • ✅ 无崩溃或异常

实际结果: _____________

📦 打包质量测试 (Package Quality Testing)

测试 15: 文件完整性 (File Integrity)

检查项:

  • 所有资源文件存在
  • 配置文件正确
  • 关卡数据完整
  • 字体文件存在
  • 音频文件存在（如有）

实际结果: _____________

测试 16: 独立运行 (Standalone Execution)

步骤:

  1. 将 dist/CircuitRepairGame/ 复制到另一台电脑
  2. 在没有 Python 环境的电脑上运行
  3. 验证所有功能正常

预期结果:

  • ✅ 无需安装 Python
  • ✅ 无需安装依赖
  • ✅ 所有功能正常

实际结果: _____________

测试 17: 文件大小 (File Size)

测试项:

  • 可执行文件大小: _______ MB
  • 总包大小: _______ MB
  • 压缩后大小: _______ MB

预期结果:

  • ✅ 总包大小 < 100MB
  • ✅ 压缩后 < 50MB

实际结果: _____________

📝 测试总结 (Test Summary)

测试统计 (Test Statistics)

  • 总测试项: 17
  • 通过: _______
  • 失败: _______
  • 跳过: _______
  • 通过率: _______ %

发现的问题 (Issues Found)

编号 问题描述 严重程度 状态
1
2
3

测试结论 (Test Conclusion)

  • ✅ 通过所有测试，可以发布
  • ⚠️ 有轻微问题，需要修复后发布
  • ❌ 有严重问题，不能发布

测试人员 (Tester)

  • 姓名: _____________
  • 日期: _____________
  • 签名: _____________

🔗 相关文档 (Related Documentation)

最后更新: 2026-01-24