refactor: improve test infrastructure and fix OpenGL GLAD initialization

- Rename D3D12Enum.h to D3D12Enums.h for naming consistency
- Fix OpenGL unit test GLAD initialization by using gladLoadGL()
  instead of gladLoadGLLoader(wglGetProcAddress) for fallback support
- Migrate remaining tests to use gtest_discover_tests for granular
  test discovery (math, core, containers, memory, threading, debug,
  components, scene, resources, input, opengl)
- Remove obsolete TEST_RESOURCES_DIR and copy_directory commands
  from OpenGL unit test CMakeLists (minimal/Res doesn't exist)
- Update TEST_SPEC.md with performance metrics and per-module
  build/test commands for faster development workflow
- Update CMake path references to use lowercase paths
This commit is contained in:
2026-03-23 00:43:02 +08:00
parent 0f0ab8922a
commit f427699ac6
100 changed files with 1191 additions and 1136 deletions

View File

@@ -62,7 +62,7 @@ RHI 模块将上层渲染逻辑与底层图形 API 解耦,通过抽象接口
| 类 | 文档 | 描述 |
|----|------|------|
| [RHIFence](rhi-fence/fence.md) | `RHIFence.h` | 同步栅栏CPU/GPU 同步原语 |
| [RHIFence](fence/fence.md) | `RHIFence.h` | 同步栅栏CPU/GPU 同步原语 |
| [RHIPipelineState](pipeline-state/pipeline-state.md) | `RHIPipelineState.h` | 管线状态对象,封装渲染管线配置 |
| [RHISampler](sampler/sampler.md) | `RHISampler.h` | 纹理采样器,配置纹理过滤和寻址模式 |
| [RHIPipelineLayout](pipeline-layout/pipeline-layout.md) | `RHIPipelineLayout.h` | 管线布局,定义着色器资源绑定布局 |

View File

@@ -1,6 +1,6 @@
# Scene 模块概览
**命名空间**: `XCEngine::Components`
**命名空间**: `XCEngine::Scene`
**类型**: `module`

View File

@@ -23,9 +23,9 @@ Mutex 类是对 std::mutex 的封装,提供线程安全的互斥访问机制
| [`Lock`](lock.md) | 获取互斥锁(非 const |
| [`Unlock`](unlock.md) | 释放互斥锁(非 const |
| [`TryLock`](trylock.md) | 尝试获取互斥锁(非 const |
| [`lock`](lock_const.md) | 获取互斥锁constSTL 兼容) |
| [`unlock`](unlock_const.md) | 释放互斥锁constSTL 兼容) |
| [`try_lock`](try_lock_const.md) | 尝试获取互斥锁constSTL 兼容) |
| [`lock`](lock-const.md) | 获取互斥锁constSTL 兼容) |
| [`unlock`](unlock-const.md) | 释放互斥锁constSTL 兼容) |
| [`try_lock`](try-lock-const.md) | 尝试获取互斥锁constSTL 兼容) |
## 使用示例
@@ -58,6 +58,6 @@ int main() {
## 相关文档
- [SpinLock](../spinlock/spinlock.md) - 自旋锁
- [ReadWriteLock](../readwritelock/readwritelock.md) - 读写锁
- [ReadWriteLock](../read-write-lock/read-write-lock.md) - 读写锁
- [TaskSystem](../task-system/task-system.md) - 任务系统
- [../threading/threading.md](../threading.md) - 模块总览

View File

@@ -19,9 +19,9 @@
| [`Lock`](lock.md) | 获取锁(忙等待) |
| [`Unlock`](unlock.md) | 释放锁 |
| [`TryLock`](trylock.md) | 尝试获取锁(非阻塞) |
| [`lock`](lock_1.md) | STL 兼容的 Lock |
| [`unlock`](unlock_1.md) | STL 兼容的 Unlock |
| [`try_lock`](try_lock.md) | STL 兼容的 TryLock |
| [`lock`](lock-stl.md) | STL 兼容的 Lock |
| [`unlock`](unlock-stl.md) | STL 兼容的 Unlock |
| [`try_lock`](try-lock.md) | STL 兼容的 TryLock |
## STL 兼容方法
@@ -52,5 +52,5 @@ void SafeIncrement() {
## 相关文档
- [Mutex](../mutex/mutex.md) - 互斥锁
- [ReadWriteLock](../readwritelock/readwritelock.md) - 读写锁
- [ReadWriteLock](../read-write-lock/read-write-lock.md) - 读写锁
- [../threading.md](../threading.md) - 模块总览

View File

@@ -0,0 +1,34 @@
# TaskGroup::TaskGroup
```cpp
TaskGroup();
```
默认构造函数。构造一个空的任务组。
**参数:**
**返回:**
**线程安全:**
**复杂度:** O(1)
**注意:**
- 构造后的任务组不包含任何任务。
- 任务组创建后需要通过 TaskSystem::CreateTaskGroup() 实际创建。
**示例:**
```cpp
#include "XCEngine/Threading/TaskGroup.h"
XCEngine::Threading::TaskGroup group;
// 使用 group 添加任务...
```
## 相关文档
- [`TaskGroup`](task-group.md) - 返回类总览
- [`AddTask`](add-task.md) - 添加任务
- [`Wait`](wait.md) - 等待任务完成

View File

@@ -0,0 +1,40 @@
# TaskGroup::~TaskGroup
```cpp
~TaskGroup();
```
析构函数。销毁任务组。
**参数:**
**返回:**
**线程安全:** ⚠️
**复杂度:** O(n)n 为任务组中的任务数
**注意:**
- 析构前会等待所有任务完成。
- 如果有任务正在执行,会等待其完成。
- 未执行的任务将被取消。
**示例:**
```cpp
#include "XCEngine/Threading/TaskGroup.h"
{
XCEngine::Threading::TaskGroup group;
group.AddTask([]() {
// 执行任务...
});
group.Wait();
} // group 在这里销毁
```
## 相关文档
- [`TaskGroup`](task-group.md) - 返回类总览
- [`Cancel`](cancel.md) - 取消任务
- [`Wait`](wait.md) - 等待任务完成

View File

@@ -24,8 +24,8 @@ TaskGroup 用于将多个相关任务组织在一起,统一管理它们的执
| 方法 | 描述 |
|------|------|
| [`Task()`](task-group.md) | 默认构造函数 |
| [`~Task()`](task-group.md) | 析构函数 |
| [`Task()`](constructor.md) | 默认构造函数 |
| [`~Task()`](destructor.md) | 析构函数 |
| [`AddTask`](add-task.md) | 添加任务到组(支持 ITask 或 Callback |
| [`AddDependency`](add-dependency.md) | 添加任务依赖关系 |
| [`Wait`](wait.md) | 阻塞等待所有任务完成 |

View File

@@ -20,7 +20,7 @@ Threading 模块提供了一套完整的多线程编程工具,包括线程封
|------|------|------|
| [Mutex](mutex/mutex.md) | `Mutex.h` | 互斥锁 |
| [SpinLock](spinlock/spinlock.md) | `SpinLock.h` | 自旋锁 |
| [ReadWriteLock](readwritelock/readwritelock.md) | `ReadWriteLock.h` | 读写锁 |
| [ReadWriteLock](read-write-lock/read-write-lock.md) | `ReadWriteLock.h` | 读写锁 |
### 线程
@@ -33,10 +33,10 @@ Threading 模块提供了一套完整的多线程编程工具,包括线程封
| 组件 | 文件 | 描述 |
|------|------|------|
| [ITask](task/task.md) | `Task.h` | 任务基类 |
| [LambdaTask](lambdatask/lambdatask.md) | `LambdaTask.h` | Lambda 任务封装模板 |
| [LambdaTask](lambda-task/lambda-task.md) | `LambdaTask.h` | Lambda 任务封装模板 |
| [TaskGroup](task-group/task-group.md) | `TaskGroup.h` | 任务组 |
| [TaskSystem](task-system/task-system.md) | `TaskSystem.h` | 并行任务调度系统 |
| [TaskSystemConfig](tasksystemconfig/tasksystemconfig.md) | `TaskSystemConfig.h` | 任务系统配置 |
| [TaskSystemConfig](task-system-config/task-system-config.md) | `TaskSystemConfig.h` | 任务系统配置 |
## 同步原语对比