- This line was added.
- This line was removed.
- Formatting was changed.
The Test Runner is the engine tool dedicated to testing certain features of the engine, projects or the plugins that have been previously implemented. The Test Runner makes it possible to run feature tests more easily and quickly; it . It is especially useful for non-programmers as it can be used to run custom tests provided that they have been previously already introduced to the Engine.
The default tests that have been provided in the Test Runner tool can only be used to test the Engine-specific features. If a different feature needs to be tested, a related test should be introduced to the Engine first.
For more information about introducing new tests to Test Runner, please refer to the Test Runner programming page.
The Test Runner tool can be used to run all the tests that are available under a category, or to run a test individually.
The Test Runner tool can be found on in Tools → Advanced → Test Runner and it is comprised of the following sections:
The Menu can be accessed via the button on the top-right corner of the Test Runner. When clicked, it reveals the following sub-menus.
|Opens the toolbar customization window allowing users to customize existing toolbars, and/or create new toolbars within the Test Runnerthis tool.|
|When disabled, the positions of toolbars and spacers within the Test Runner this tool can be changed by drag and drop.|
The following options allow users to use spacers in positioning their toolbars.
|Toolbars||Lists all default and custom toolbars created for the Test Runnerthis tool, allowing you to select which toolbar you'd like to hide or display.|
When a tool has a toolbar, whether this is a default one or a custom one, the options above are also available when right-clicking in the toolbar area (only when a toolbar is already displayed).
Displays the panels that have been previously closed or not yet opened on in the Test Runner panel.
The following panels can be displayed via with this option:
Resets the layout. This option is a quick way to go back to the default Test Runner layout.
Opens the documentation page for this tool.
2. Tests Panel
The Tests panel displays all the available tests that can be executed. These can either be the default tests or the custom ones that were already implemented introduced to the Engine by the user.
When a single test or a category is right-clicked, a context menu appears with Run selected tests option which then can be clicked upon to execute these test(s).
The Tests panel is comprised of the following sections:
|Run All||Executes all the tests that are currently available in the Tests list.|
|Search Bar||Searches for a specific test based on its name, narrowing down the scope of the displayed displaying only the related tests on the list.|
|Tests||Displays the tests that can be executed.|
|Results||Displays the result of the tests that has have been previously executed.|
3. Output Panel
The Output panel of the Test Runner tool displays the result of each test that has been previously executed. The outcome of each tool test can be different depending on whether a test it fails or succeeds.
The Output panel is especially useful to see where exactly in the Engine a test failed and why. It then helps the user to track down find the source of the problem and potentially fix it.
|The test results will be archived in <Project Folder>\user\testresults, as an .xml file.|
On This Page
Table of Contents maxLevel 4 minLevel 2