|The information in this topic applies to desktop and mobile applications. To learn how to run web browsers, see Launch Web Browsers and Launching Mobile Browser Emulator.
The information in this topic does not apply to mobile applications to be uploaded to the BitBar device cloud. To learn how to run such applications, see Connecting to Mobile Device Clouds and Opening Testing Sessions.
TestComplete lets you automatically launch your tested application during test recording and test runs. You can launch applications from the TestComplete IDE and by using the appropriate test commands.
For generic Windows applications, TestComplete supports multiple run modes - Simple, RunAs, Debug and Profile. TestComplete launches these applications in the mode specified in the TestedApps editor or in your tests.
Running Applications From the TestComplete IDE
To run your tested application:
Right-click the application in the Project Explorer and select Run from the context menu.
Right-click the application in the TestedApps editor and select Run from the context menu.
To run all the tested applications:
Right-click the TestedApps node in the Project Explorer and select Run All from the context menu.
Right-click somewhere in the TestedApps editor and select Run All from the context menu.
Running Applications During Test Recording
To launch your tested application during test recording, select it from the application list on the Recording toolbar.
You can also configure TestComplete to automatically launch all or specific tested applications every time you start test recording. To do this:
Open the TestedApps editor.
Select an application in the list and then select the Autorun application on recording check box in the application parameters.
|Note:||This option is not currently supported for iOS applications.|
If your application is not in the TestedApps editor, you can launch it in a usual way (for example, by using a desktop shortcut or via the Start menu), and TestComplete will automatically add it to the TestedApps editor.
In any case, TestComplete will add the application launch operation to your recorded test.
Running Applications From Keyword Tests
In keyword tests, use the Run TestedApp operation to launch your tested application. You typically add this operation at the beginning of your tests.
To run several instances of the application, specify the number of instances in the operation’s Count parameter.
Running Applications From Scripts
To run a tested application, call the
If your tested application is a desktop application, you can run several instances of it:
You can also run your desktop tested application by calling the
DbgServices.LaunchAllTestedApplications method. These methods start the application and command TestComplete to act as a debugger for the application process. TestComplete will trace and report events (with call stack) and debug strings that occur during the application run.
If you have several tested applications in the Tested Applications collection, you can run all of them by calling the
Running Applications Under Another Account
To run your tested application under a different user account, you can use the
TestedApps.notepad.RunAs("DOMAIN", "user", "password");
TestedApps.notepad.RunAs("DOMAIN", "user", "password")
Call TestedApps.notepad.RunAs("DOMAIN", "user", "password")
TestedApps.notepad.RunAs('DOMAIN', 'user', 'password');
TestedApps["notepad"]["RunAs"]("DOMAIN", "user", "password");
Another way is to select the RunAs mode for your application and specify the needed user account in the TestedApps editor. In this case, if you run the application from the TestedApps editor, it will be launched under the specified account.
For more information, see Testing Applications Running Under Another User Account.
TestComplete will not launch an application if the Launch application from tests check box is clear for the application in the TestedApps editor.
To use the RunAs or Profile mode, you must run TestComplete as an administrator. See Using TestComplete With Administrator Privileges.
For the specifics of running mobile applications, see the following topics:
In rare cases, your application may hang if you run it from the TestedApps editor. In this case, you can do one of the following:
Create a batch file (.bat) that runs your application and add this file to the TestedApps editor instead of your application. For example:
start "" "C:\Program Files\My App\My App.exe"
Run your application without using the TestedApps editor. For example, you can use the
WshShellscripting object instead: