# Unity 测试运行器 ## 概述此技能可以直接从命令行自动执行和分析 Unity Test Framework 测试。它处理完整的测试工作流程：检测跨平台 (Windows/macOS/Linux) 的 Unity 编辑器安装、配置测试参数、在 EditMode 或 PlayMode 中执行测试、解析 NUnit XML 结果以及生成具有可操作见解的详细故障报告。 ## 何时使用此技能在以下情况下使用此技能： * 从命令行执行Unity Test Framework测试 * 运行 PlayMode 或 EditMode 测试来验证游戏逻辑 * 分析测试失败并生成失败报告 * 将 Unity 测试集成到 CI/CD 管道中 * 使用详细的堆栈跟踪和文件位置调试测试失败 * 在提交之前验证 Unity 项目更改 **用户请求示例：** *“在我的项目中运行所有 Unity 测试” *“执行 PlayMode 测试并显示结果” *“在战斗类别中运行测试” *“检查我的 Unity 测试是否通过” *“仅运行编辑模式测试” ## 工作流程调用技能时请遵循以下工作流程： ### 1\.检测 Unity 编辑器安装使用“find-unity-editor.js”脚本自动定位Unity编辑器：节点脚本/find-unity-editor.js --json **脚本行为：** * 扫描特定于平台的默认安装路径 * 检测所有已安装的Unity版本 * 默认返回最新版本 * 可以使用 `--version ` 标志定位特定版本 **输出：** { “发现”：真实， "editorPath": "C:\\Program Files\\Unity\\Hub\\Editor\\2021.3.15f1\\Editor\\Unity.exe", "版本": "2021.3.15f1", “平台”：“win32”， "allVersions": ["2021.3.15f1", "2020.3.30f1"] } **如果找到多个版本：** 1. 向用户呈现所有可用版本 2.要求用户确认使用哪个版本 3.或者默认使用最新版本 **如果没有找到Unity编辑器：** * 报告搜索路径错误 * 要求用户手动提供Unity Editor路径 * 保存路径以备将来使用 ### 2\.验证 Unity 项目路径使用跨平台检查确认当前目录包含有效的 Unity 项目： // 使用Read工具检查Unity项目指标读取({ file_path: "ProjectSettings/ProjectVersion.txt" }) // 使用Glob来验证Assets目录是否存在 Glob({ 模式: "资产/*", 路径: "." }) **验证步骤：** 1.验证`Assets/`目录是否存在 2.验证“ProjectSettings/ProjectVersion.txt”是否存在 3.读取`ProjectVersion.txt`获取Unity版本 4.编辑器版本与项目版本不匹配时发出警告 **示例 ProjectVersion.txt：** m_Editor版本：2021.3.15f1 m_EditorVersionWithRevision: 2021.3.15f1 (e8e88743f9e5) ### 3\.配置测试设置确定测试执行参数。如果未指定参数，请使用“AskUserQuestion”工具： **所需设置：** * **测试模式**：编辑模式、播放模式或两者 * **测试平台** ：EditMode测试使用“EditMode”，PlayMode可以指定平台（例如，“StandaloneWindows64”、“Android”、“iOS”） **可选设置：** * **测试类别**：以分号分隔的列表（例如，“战斗；AI；物理”） * **测试过滤器** ：正则表达式模式或分号分隔的测试名称 * **结果输出路径** : 默认为项目根目录中的 `TestResults.xml` **配置示例：** 询问用户问题({ 问题：[{ 问题：“应该执行哪种测试模式？”，标题：“测试模式”，多重选择：假，选项：[ { label: "EditMode Only", description: "快速单元测试，无需播放模式" }, { label: "PlayMode Only", description: "完整 Unity 引擎测试" }, { 标签：“两种模式”，描述：“运行所有测试（较慢）” } ] }] }) ### 4\.通过命令行执行测试构建并执行Unity命令行测试命令： **命令结构：** -runTests -batchmode -projectPath <项目路径> \ -testPlatform <编辑模式|播放模式> \ -testResults <输出路径> \ [-testCategory <类别>] \ [-testFilter <过滤器>] \ -日志文件- **命令示例：** **编辑模式测试：** “C：\ Program Files \ Unity \ Hub \ Editor \ 2021.3.15f1 \ Editor \ Unity.exe”\ -runTests -batchmode \ -projectPath "D:\Projects\MyGame" \ -testPlatform编辑模式\ -testResults“TestResults-EditMode.xml”\ -日志文件- **使用类别过滤器进行 PlayMode 测试：** “C：\ Program Files \ Unity \ Hub \ Editor \ 2021.3.15f1 \ Editor \ Unity.exe”\ -runTests -batchmode \ -projectPath "D:\Projects\MyGame" \ -testPlatform 播放模式 \ -testResults“TestResults-PlayMode.xml”\ -testCategory“战斗；AI”\ -日志文件- **执行说明：** * 使用“Bash”工具和“run_in_background: true”进行长时间运行的测试 * 适当设置超时时间（默认：5-10分钟，根据测试次数调整） * 监控进度指示器的输出 * 捕获stdout和stderr **执行示例：** 重击（{ 命令： `"${unityPath}" -runTests -batchmode -projectPath "${projectPath}" -testPlatform EditMode -testResults "TestResults.xml" -logFile -`, 描述：“执行Unity EditMode测试”，超时: 300000, // 5 分钟 run_in_background：true }) ### 5\.解析测试结果测试完成后，使用“parse-test-results.js”解析 NUnit XML 结果：节点脚本/parse-test-results.js TestResults.xml --json **脚本输出：** { “摘要”：{ “总计”：10， “通过”：7， “失败”：2， “跳过”：1， “持续时间”：12.345 }, “失败”：[ { "name": "TestPlayerTakeDamage", "fullName": "Tests.Combat.PlayerTests.TestPlayerTakeDamage", "message": "预期：90\n 但实际是：100", "stackTrace": "在 Assets/Tests/Combat/PlayerTests.cs:42 中的 Tests.Combat.PlayerTests.TestPlayerTakeDamage () [0x00001]", "file": "资产/测试/战斗/PlayerTests.cs", “行”：42 } ], “所有测试”：[...] } **结果分析：** 1. 提取测试汇总统计数据 2. 识别所有失败的测试 3. 从堆栈跟踪中提取文件路径和行号 4. 按类型对失败进行分类（断言、异常、超时） ### 6\.分析测试失败对于每个失败的测试，使用“references/test-patterns.json”分析失败： **分析步骤：** 1. **加载测试模式数据库：** 读取({ file_path: "references/test-patterns.json" }) 2. **根据模式匹配失败消息：** * 断言失败：`预期：但实际是：` * 空引用失败：`预期：不为空但为：` * 超时失败：`TimeoutException|测试超出时间限制` * 线程错误：`无法从*主线程调用` * 对象生命周期问题：`已被销毁|MissingReferenceException` 3. **确定故障类别：** * ValueMismatch：断言值不正确 * NullValue：意外的空引用 * 性能：超时或执行缓慢 * TestSetup：安装/拆卸失败 * ObjectLifetime：被破坏的对象访问 * 线程：错误的线程执行 4. **生成修复建议：** * 从 test-patterns.json 加载通用解决方案 * 将解决方案与故障模式相匹配 * 提供具体的代码示例 **故障分析示例：** **测试**：Tests.Combat.PlayerTests.TestPlayerTakeDamage **位置**：资产/测试/战斗/PlayerTests.cs:42 **结果**：失败 **失败消息**：预计：90 但是是：100 **分析**： - 类别：ValueMismatch（断言失败） - 模式：预期/实际值不匹配 - 根本原因：调用 TakeDamage() 后玩家的生命值没有减少 **可能的原因**： 1. TakeDamage()方法没有正确实现 2. 玩家生命值未正确初始化 3.伤害值传递错误 **建议的解决方案**： 1. 验证 TakeDamage() 实现： ``csharp 公共无效TakeDamage（int伤害）{ 健康-=伤害； // 确保该行存在 } 2. 检查测试设置： [设置] 公共无效设置（）{ 玩家=新玩家(); 玩家.生命值 = 100; // 确保正确的初始化 } 3. 验证测试断言：玩家.TakeDamage(10); Assert.AreEqual(90, 玩家.Health); // 预期：90 ### 7. 生成测试报告为用户创建全面的测试报告： **报告结构：** ``降价 # 统一测试结果 ## 总结 - **总测试**：10 - **✓ 通过**：7 (70%) - **✗ 失败**：2 (20%) - **⊘ 跳过**：1 (10%) - **持续时间**：12.35 秒 ## 测试分解 - **编辑模式测试**：5 次通过，1 次失败 - **PlayMode 测试**：2 次通过，1 次失败 ## 测试失败 ### 1.Tests.Combat.PlayerTests.TestPlayerTakeDamage **位置**：资产/测试/战斗/PlayerTests.cs:42 **失败**：预期：90，但实际是：100 **分析**：调用 TakeDamage() 后玩家的生命值没有减少。 **建议修复**：验证 TakeDamage() 实施是否正确降低了运行状况。 --- ### 2.Tests.AI.EnemyTests.TestEnemyChasePlayer **位置**：资产/测试/AI/EnemyTests.cs:67 **失败**：TimeoutException - 测试超出时间限制（5 秒） **分析**：协程测试中无限循环或丢失产量。 **建议修复**：添加“[UnityTest]”属性并在测试循环中使用“yield return null”。 --- ## 后续步骤 1. 检查失败的测试位置并修复实施 2.修复后通过重新调用技能重新运行测试 3.考虑为边缘情况添加更多断言 **报告交付：** * 以 Markdown 格式呈现报告 * 突出显示关键故障 * 提供文件：行参考以进行快速导航 * 如果用户请求，提供帮助修复特定故障 ## 最佳实践使用该技能时： 1. **首先运行 EditMode 测试** \- 它们速度更快并捕获基本逻辑错误 * 为 Unity 特定功能保留 PlayMode 测试 * 使用EditMode进行纯C#逻辑和数据结构 2. **使用测试类别** \- 过滤测试以加快迭代速度 * `-testCategory "Combat"` 仅运行 Combat 测试 * 在积极开发特定功能期间有帮助 3. **监控测试持续时间** \- 设置适当的超时 * 编辑模式：通常为 1-3 分钟 * 播放模式：通常为 5-15 分钟 * 根据测试次数调整超时 4. **检查Unity版本兼容性** \- 确保编辑器与项目版本匹配 * 版本不匹配可能会导致测试失败 * 不同版本测试结果可能不一致 5. **立即解析结果** \- 无需等待人工审核 * 自动解析更快地捕获问题 * 提供可操作的文件：行信息 6. **分析故障模式** \- 查找常见原因 * 类似的失败通常表明存在系统性问题 * 解决根本原因而不是个别症状 7. **保留测试结果** \- 保留 XML 文件以供调试 * 结果包含完整的堆栈跟踪 * 用于比较测试运行 8. **处理长时间运行的测试** \- 使用后台执行 * 使用“BashOutput”工具监控进度 * 向用户提供状态更新 ## 资源 ### 脚本/find-unity-editor.js 跨平台Unity Editor路径检测脚本。自动扫描 Windows、macOS 和 Linux 的默认安装目录，检测所有已安装的 Unity 版本，并返回最新版本或特定请求的版本。 **用途：** # 查找最新的Unity版本节点脚本/find-unity-editor.js --json # 查找特定版本节点脚本/find-unity-editor.js --version 2021.3.15f1 --json **输出**：带有 Unity 编辑器路径、版本、平台和所有可用版本的 JSON。 ### 脚本/parse-test-results.js 用于 Unity 测试框架输出的 NUnit XML 结果解析器。从 XML 结果中提取测试统计信息、故障详细信息、堆栈跟踪和文件位置。 **用途：** # 用 JSON 输出解析测试结果节点脚本/parse-test-results.js TestResults.xml --json # 使用格式化的控制台输出进行解析节点脚本/parse-test-results.js TestResults.xml **输出**：带有测试摘要的 JSON、失败详细信息（包括文件路径和行号）以及完整的测试列表。 ### 参考文献/test-patterns.json Unity 测试模式、NUnit 断言、常见故障模式和最佳实践的综合数据库。包括： * NUnit 断言参考（相等、集合、异常、Unity 特定） * 正则表达式匹配的常见故障模式 * 故障类别及根本原因分析 * 带有代码示例的解决方案模板 * 编辑模式与播放模式指南 * Unity 特定的测试模式（协程、场景、预制件、物理） * 测试最佳实践 **用法** ：在分析测试失败时加载此文件，以将失败消息与模式进行匹配并生成修复建议。

统一测试运行器

包含技能