Edit Mode vs. Play Mode tests
Let’s clarify a bit what Play Mode and Edit Mode test means from the Unity Test Framework perspective:
Edit Mode tests
Edit Mode tests (also known as Editor tests) are only run in the Unity Editor and have access to the Editor code.
Note: You can also control entering and exiting Play Mode from your Edit Mode test.
Edit Mode tests should meet one of the following conditions:
- They should have an assembly definition file, that references
NUnitand has only the Editor as a target platform:
- Legacy condition: put tests in the project’s Editor folder.
Play Mode tests
You can run Play Mode tests as a standalone in a Player or inside the Editor. Play Mode tests allow you to exercise your game code, as the tests run as coroutines if marked with the
Play Mode tests should correspond to the following conditions:
- Have an assembly definition with reference to nunit.framework.dll.
- Have the test scripts located in a folder with the .asmdef file.
- The test assembly should reference an assembly within the code that you need to test.
Use the NUnit
Test attribute instead of the
UnityTest attribute, unless you need to yield special instructions, in Edit Mode, or if you need to skip a frame or wait for a certain amount of time in Play Mode.
Reference in your tests
UnityEditor.TestRunner, only Edit Mode tests requires the latter. The
TestAssemblies option under
optionalUnityReference is auto-updated into a reference to the