140 lines
3.0 KiB
Markdown
140 lines
3.0 KiB
Markdown
# Extra2D 测试套件
|
||
|
||
## 概述
|
||
|
||
本测试套件包含对 Extra2D 引擎核心模块的单元测试和集成测试。
|
||
|
||
## 测试框架
|
||
|
||
使用自定义轻量级测试框架，位于 `test_framework.h`。
|
||
|
||
### 特性
|
||
- 自动测试注册和发现
|
||
- 支持测试套件组织
|
||
- 丰富的断言宏
|
||
- 详细的测试报告
|
||
|
||
## 测试文件说明
|
||
|
||
| 文件 | 描述 | 测试数量 |
|
||
|------|------|----------|
|
||
| `test_timer_module.cpp` | 定时器模块测试 | 20+ |
|
||
| `test_event_bus.cpp` | 事件总线测试 | 20+ |
|
||
| `test_module_registry.cpp` | 模块注册表测试 | 12+ |
|
||
| `test_plugin_loader.cpp` | 插件加载器测试 | 15+ |
|
||
| `test_context.cpp` | Context 集成测试 | 15+ |
|
||
|
||
## 构建和运行
|
||
|
||
### 构建测试
|
||
|
||
```bash
|
||
# 配置并构建测试
|
||
xmake f --tests=y
|
||
xmake
|
||
|
||
# 或者显式指定平台
|
||
xmake f -p mingw --tests=y
|
||
xmake
|
||
```
|
||
|
||
### 运行测试
|
||
|
||
```bash
|
||
# 运行所有测试
|
||
xmake run extra2d_tests
|
||
|
||
# 或者在构建目录中直接运行
|
||
./build/mingw/x86_64/debug/extra2d_tests.exe
|
||
```
|
||
|
||
## 测试覆盖范围
|
||
|
||
### TimerModule 测试
|
||
- 基础属性和生命周期
|
||
- 一次性定时器（scheduleOnce）
|
||
- 重复定时器（scheduleRepeat）
|
||
- 每帧更新定时器（scheduleUpdate）
|
||
- 暂停和恢复功能
|
||
- 时间缩放效果
|
||
- 多定时器管理
|
||
- 边界条件处理
|
||
|
||
### EventBus 测试
|
||
- 基础事件广播
|
||
- 多监听器支持
|
||
- 监听器启用/禁用
|
||
- 带参数事件
|
||
- 不同事件类型
|
||
- 监听器生命周期（RAII）
|
||
- 输入事件（键盘、鼠标、触摸）
|
||
- 窗口事件
|
||
- 游戏手柄事件
|
||
- 性能测试
|
||
|
||
### ModuleRegistry 测试
|
||
- 基础注册/注销操作
|
||
- 重复注册处理
|
||
- 按类型获取模块
|
||
- 初始化和关闭顺序
|
||
- 优先级排序
|
||
- 空注册表处理
|
||
|
||
### PluginLoader 测试
|
||
- 基础注册/卸载操作
|
||
- 插件加载和卸载
|
||
- 依赖关系解析
|
||
- 加载顺序验证
|
||
- 缺失依赖处理
|
||
- 循环依赖处理
|
||
- 复杂依赖图
|
||
|
||
### Context 集成测试
|
||
- 创建和销毁
|
||
- 初始化和关闭
|
||
- 时间推进
|
||
- 停止请求
|
||
- 组件访问（模块、插件、定时器）
|
||
- 事件广播
|
||
- 多 Context 支持
|
||
- 定时器集成
|
||
- 完整生命周期
|
||
- 性能测试
|
||
|
||
## 添加新测试
|
||
|
||
使用 `TEST` 宏添加新测试：
|
||
|
||
```cpp
|
||
#include "test_framework.h"
|
||
#include <your_module.h>
|
||
|
||
using namespace extra2d;
|
||
using namespace extra2d::test;
|
||
|
||
TEST(SuiteName, TestName) {
|
||
// 测试代码
|
||
ASSERT_EQ(expected, actual);
|
||
ASSERT_TRUE(condition);
|
||
ASSERT_NOT_NULL(ptr);
|
||
}
|
||
```
|
||
|
||
## 断言宏
|
||
|
||
- `ASSERT_TRUE(expr)` - 断言表达式为 true
|
||
- `ASSERT_FALSE(expr)` - 断言表达式为 false
|
||
- `ASSERT_EQ(expected, actual)` - 断言相等
|
||
- `ASSERT_NE(expected, actual)` - 断言不相等
|
||
- `ASSERT_NULL(ptr)` - 断言指针为 null
|
||
- `ASSERT_NOT_NULL(ptr)` - 断言指针不为 null
|
||
- `ASSERT_THROW(expr, ExceptionType)` - 断言抛出异常
|
||
- `ASSERT_NO_THROW(expr)` - 断言不抛出异常
|
||
|
||
## 注意事项
|
||
|
||
1. 测试使用静态注册，自动发现并运行
|
||
2. 每个测试用例独立运行，互不影响
|
||
3. 测试框架会捕获异常并报告错误
|
||
4. 支持测试跳过（skip）功能
|