Unreal Engine CQTest 测试代码生成

Skill 定位

用于快速选择测试类型、套用模板与 Helper，并给出 CQTest 结构化写法与 Latent Actions 使用建议。

前置准备

• CQTest 模块已添加到项目 Build.cs 的依赖列表中
• 需要时启用 Code Quality Unreal Test Plugin（可选，仅供参考）
• 项目已配置好编译环境

public class TestsRuntime : ModuleRules
{
	public TestsRuntime(ReadOnlyTargetRules Target) : base(Target)
	{
		PrivateDependencyModuleNames.AddRange(
			new string[]
			{
				"CQTest",
				"CQTestEnhancedInput",
			}
		);
		

		if (Target.bBuildEditor)
		{
			PrivateDependencyModuleNames.AddRange(
				new string[] {
					"EngineSettings",
					"LevelEditor",
					"UnrealEd"
			});
		}
	}
}

快速选择

• 基础断言 → TEST（模板：basic-test-template.cpp）
• 结构化测试 → TEST_CLASS（模板：test-class-template.cpp）
• Actor → ActorTestHelper（模板：actor-test-template.*）
• Animation → AnimationTestHelper（模板：animation-test-template.*）
• Input → InputTestHelper（模板：input-test-template.*）
• Network → PIENetworkComponent（模板：network-test-template.*）
• Map → MapTestSpawner（模板：map-test-template.cpp）

使用流程

1. 选择测试类型与模板
2. 替换命名空间、类名、测试方法名
3. 填充 BEFORE_EACH/AFTER_EACH 与断言
4. 需要多帧逻辑时引入 Latent Actions
5. 在 Unreal Editor 的 Sessions Frontend 运行测试

资源索引

• CQTest 核心概念：references/cqtest-framework.md
• 测试组件说明：references/test-components.md
• 测试类型详解：references/test-types.md
• Latent Actions：references/latent-actions.md
• 最佳实践：references/best-practices.md
• 模板与 Helper：见 assets/templates/ 与 assets/helpers/

注意事项

• 优先使用 Latent Actions（FWaitUntil）而非固定延时（FWaitDelay）以提高稳定性
• 确保每个测试独立，避免依赖执行顺序
• 使用 AFTER_EACH 正确清理资源，避免泄漏
• 涉及网络或 Blueprint 的测试需指定 EAutomationTestFlags::EditorContext
• 测试命名建议：测试场景_预期行为
• 使用 TEST_CLASS 的 Setup/Teardown 机制减少重复代码
• 测试地图不要放在 /Maps 目录，避免被默认烘焙；可放到 DirectoriesToNevercook 标记的目录