SuperAPI AI 工具集

unity-test-runner

测试与质量

查看项目

更新于 10-15 21:08

技能介绍

用途:在命令行中自动化执行和分析 Unity Test Framework(NUnit)测试,覆盖从检测编辑器到生成报告的全流程,适合在提交前验证改动或接入 CI/CD。

主要能力:

  1. 编辑器检测:运行 node scripts/find-unity-editor.js --json,跨平台扫描默认安装路径,列出已安装版本,默认返回最新版,也可用 --version 指定版本。
  2. 项目校验:检查 Assets/ 与 ProjectSettings/ProjectVersion.txt,提示编辑器版本与项目版本不一致。
  3. 测试配置:选择 EditMode、PlayMode 或两者;可指定测试平台、测试类别(如 -testCategory "Combat;AI")和测试过滤;结果默认输出 TestResults.xml。
  4. 执行测试:使用 Unity 命令行参数,如 <UnityEditorPath> -runTests -batchmode -projectPath <ProjectPath> -testPlatform EditMode -testResults <OutputPath> -logFile -;耗时测试可后台运行并设置超时。
  5. 结果解析:运行 node scripts/parse-test-results.js TestResults.xml --json,输出总数、通过、失败、跳过、耗时及失败详情(消息、堆栈、文件与行号)。
  6. 失败分析:结合 references/test-patterns.json 匹配断言失败、空引用、超时、线程错误、对象生命周期等模式,归类原因并给出修复建议,最后生成 Markdown 测试报告。

使用方式:调用技能后按工作流依次检测编辑器、校验项目、确认参数、执行命令、解析 XML、分析失败并输出报告;未指定参数时可用 AskUserQuestion 询问。

适用场景:命令行运行 EditMode/PlayMode 测试、按类别过滤测试、CI/CD 集成、失败调试与提交前验证。

限制:依赖已安装的 Unity Editor 与 Node 脚本;PlayMode 测试耗时较长;版本不匹配可能导致失败或不一致;具体平台与超时需按项目调整。资料未提供收费与价格信息。