使用 Unity 测试框架测试游戏代码

If you are new to the Unity Test Framework (UTF), read the documentation for an introduction. In brief, the UTF enables Unity users to test their code in both Edit Mode and Play Mode, and also on target platforms such as Standalone, Android, iOS, and others.

UTF uses a Unity integration of the NUnit library, which is an open-source unit testing library for .Net languages. For more information about NUnit, see the official NUnit website and the NUnit documentation on GitHub. 

You might also find these blog posts informative:

Performance benchmarking in Unity: How to get started

Testing test-driven development with the Unity Test Runner

Another related solution to learn about is Backtrace, an error management platform that enables you to capture crashes and exceptions and fix them quickly. Watch this Unite Now session for an in-depth introduction. 

您可以通过 Test Runner API（请参阅下面的 API）从任何脚本以编程方式运行测试。它允许您检索将在“编辑模式”、“播放模式”或同时在这两种模式下运行的测试的列表（不运行它们）。您可以在每个测试的开始和结束、测试周期（即整个测试程序集）中的每个级别、每个单独的测试固定例程以及每个测试类和测试上挂接一些注册/取消注册回调。

在每个测试开始时，您将获得有关将要运行的测试路线的信息。测试完成后，您将看到测试结果。

除了在 Unity Editor 中以“播放模式”运行 UTF 之外，还可以使用新的自定义点在目标设备上运行它。这是在构建 Player 之前调用的；您可以修改 Player 构建选项，例如，更改测试运行设置和指定构建位置。

如果您要在未连接到本地计算机的目标设备上运行测试，例如，目标设备位于云中（或是云中的多个设备），则拆分构建和运行过程会很有用。

为此，您首先需要自定义测试 Player 构建过程本身。方法如下：

• 禁用自动运行功能，以便在您构建 Player 之后，它不会启动并运行测试。
• 将其保存到已知位置，而不是保存到系统的临时文件夹（默认将保存到该位置）。

然后，您在 Player 侧添加自定义结果报告（使用回调接口）以捕获所有结果，并将它们保存为 XML 文件或适合您的项目的任何格式。

请查看以下代码示例，以了解如何拆分构建和运行。在 Unite 主题演讲中，Richard Fine 逐步介绍了该应用程序的构建和结果报告这两部分的代码（6:28 处）。

构建：

运行：

通常，当开发者编写验证时，结果将显示在控制台窗口中，由于此处包含源源不断的消息，很容易令开发者迷失。如果您可以在编辑器中专用位置的测试套件中获得具有明确指示符的验证结果，会怎么样？这可以通过启动菜单项指示的特定测试来实现。

首先，您需要编写连接到 MenuItem 的方法，这与实现任何其他编辑器扩展菜单项的方式完全相同。然后，该方法创建一个 ScriptableObject 回调对象。您将使用 ScriptableObject 而不是常规类，以便测试可以进行一些操作，例如导致域重新加载，同时保持回调完整。启用 ScriptableObject 时，将为回调注册该对象，而禁用 ScriptableObject 时，则将其取消注册。

然后，设置筛选条件。通常，在启动 MenuItem 的测试时，需要运行特定类别或组的测试。使用筛选条件，您可以异步执行测试运行。它将运行数帧，以便您可以让 UnityTest、UnitySetUp 和 UnityTearDown 在测试期间记录引擎循环。当测试完成并注册 RunFinished 时，您可以将其设置为显示消息或打开结果窗口等任何对您的工作流程有意义的操作。

请参阅下面的代码示例。Richard 在 Unite 主题演讲中介绍了该应用程序的代码设置（11:50 处）。 

在构建前运行测试可能会很棘手，因为构建过程需要从回调运行测试，因此没有机会启动引擎更新循环。但这样做的好处是，您可以在花时间进行实际构建（对于某些项目，这可能要花很长时间）之前检查基本功能是否正常运行。

您可以使用 IPreprocessBuildWithReport 接口来实现该应用程序，就像您实现任何其他类型的构建预处理一样。要获得结果，请像往常一样注册回调。

由于无法在构建过程中进入“播放模式”，因此可以使用 Test Runner API 在“编辑模式”下运行特定的测试。您可以通过按类别（例如，预构建验证测试类别）筛选来选择测试。您可以同步运行这些测试。

测试完成后，检查结果。如果出现任何问题，您可以抛出 BuildFailed 异常，这将导致构建过程中止。

该应用程序可以分为两部分 - ResultCollector 和预处理器 - Richard 在他们的演讲中详细介绍了这些内容（15:20 处）。

观看 Christian 和 Richard 的 Test Runner API 现场演示。请观看整个演讲，以获取更多 QA 提示！