EasyTest functional tests can be run from Visual Studio. However, functional testing takes time. So usually, it does not make sense to run all the functional tests on a developer's personal computer. As the number of tests increases, it becomes much more convenient to run the tests on a separate server. In this scenario, the test executor utility should be used. This topic provides general information on the utility, and lists the command-line parameters supported by it. For information on how to run EasyTest tests from Visual Studio, refer to the EasyTest Basics topic.
The test executor utility is a command-line tool available in the %PROGRAMFILES(x86)%\DevExpress 20.1\Components\%PROGRAMFILES(x86)%\DevExpress 20.1\.NET Core Desktop Libraries\Tools\eXpressAppFramework\EasyTest folder by default. This tool can perform EasyTest functional tests and produce XML output logs. If a test did not pass, then in addition to the log file, a screenshot is created, capturing the state of the application's UI at the time of failure. Currently, this screenshot is represented by a JPEG picture for a Windows Forms application, and an HTML page for an ASP.NET application. The following image demonstrates how the test executor works.
The test executor utility has the following command-line syntax:
TestExecutor.v20.1.exe <script_file> | <scripts_dir> [-p:<profile_name>] [-d:<script_line_number_to_stop>] [-l:<LogFileName>] [-o:<alias_name>=<alias_value>]
|script_file||Required||Specifies the name of the script file containing the test that must be performed.||
|scripts_dir||Required||Specifies the name of the directory containing the script files to be executed sequentially.||
|-p||Optional||Specifies the EasyTest configuration profile that must be used when performing a test.||
|-d||Optional||Specifies that a test script should be run in debug mode. To start execution of the script, you will need to press the ENTER key after the "Press <Enter> to start test" message has been displayed. The script will be executed up to the line specified by this parameter's argument. After that, the "Press <Enter> to process command" message is displayed and you will need to press the ENTER key after each script file line to continue script execution.||
|-l||Optional||Specifies the XML log file name. If this parameter is not specified, the log file name specified in the TestExecutor.v20.1.exe.config is used.||
|-o||Optional||Overrides the value of an alias declared in the test configuration file.||
To run a single test script, pass its file name. To sequentially run all test scripts located within a certain directory, pass this directory name.
EasyTest requires interactive UI on the test server (a user must be logged in).