Running Tested Applications

Running Applications From the TestComplete IDE

Running Applications During Test Recording

Running Applications From Keyword Tests

Running Applications From Scripts

Running Applications Under Another Account

Notes

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.

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.

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.

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.

To run a tested application, call the TestedApp.Run method:

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.LaunchTestedApplication or 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 TestedApps.RunAll method:

To run your tested application under a different user account, you can use the TestedApps.AppName.RunAs method:

In keyword tests, you can call the RunAs method using the Call Object Method or Run Code Snippet operation.

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:

  Starting Tested Android Applications

  Starting Tested iOS Applications

• 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:

    MyApp.bat

    MyApp.bat

    start "" "C:\Program Files\My App\My App.exe"

  • Run your application without using the TestedApps editor. For example, you can use the WshShell scripting object instead:

    JavaScript, JScript

    Python

    VBScript

    DelphiScript

    C++Script, C#Script

    JavaScript, JScript

    WshShell.Run("notepad");

    Python

    WshShell.Run("notepad")

    VBScript

    Call WshShell.Run("notepad")

    DelphiScript

    WshShell.Run('notepad');

    C++Script, C#Script

    WshShell["Run"]("notepad");