Adding Tested Applications

When creating a project

When recording a test

Manually in the Tested Apps editor

From the Object Browser (for desktop Windows applications only)

During test recording (for desktop applications)

From tests

By copying existing tested applications in the project

When you are adding a new project with the Create New Project wizard at design time, you can choose the application to be tested: desktop or mobile.

When you start test recording with the Record Test wizard, TestComplete asks you to select the application for which you will record the test. TestComplete will add the application to the list of tested applications and start recording.

1. If your project does not have the Tested Applications collection, add it:

   

   Click the image to enlarge it.

2. Right-click somewhere within the Tested Apps editor and select  Add Application from the context menu.

   – or –

   Right-click the TestedApps node in the Project Explorer panel and select  New Item from the context menu.

3. The Add Tested Application wizard will appear. Follow the wizard instructions to add the desired application to the project.

   To learn how to add various types of tested applications, see:

   Java and JavaFX applications

   Java Web Start applications

   AIR applications

   ClickOnce applications

   Windows Store applications

   BitBar and local Appium applications

   Android applications (Legacy)

   iOS applications (Legacy)

Right-click the application’s process (or any of its child objects) in the Object Browser’s Object Tree and select  Add Process to TestedApps from the context menu.

When you launch a generic Windows application during test recording, TestComplete can automatically add that application to the Tested Applications collection of your project.

You can control this behavior by using the Automatically add applications to the Tested Applications list and Show 'Add <ApplicationName> to the list of tested applications?' message options.

You can add applications to the Tested Applications collection and define their properties directly from your tests. To do this, use the following methods of the TestedApps object.

You must have the Tested Applications collection in your TestComplete project to be able to call these methods.

Not applicable to mobile applications to run in the BitBar mobile device cloud. To learn how to run them from tests, see Connecting to Mobile Devices and Opening Testing Sessions.

The following sample code demonstrates how you can use the TestedApps.Add method to add Notepad to the Tested Applications collection:

def AddTestedApp():
  
  # Add Notepad to Tested Applications
  ind = TestedApps.Add("%WINDIR%\\notepad.exe");
  Log.Message(aqString.Format('Notepad was added to TestedApps under the name "%s" and index %d.',\
              TestedApps.Items[ind].ItemName, ind) )

  # Launch Notepad
  TestedApps.Items[ind].Run()

To define a tested application from keyword tests, call the described method by using the Call Object Method or Run Code Snippet operation.

1. Right-click the desired item in the Tested Apps editor and select Copy from its context menu.

2. Right-click somewhere within the editor and select Paste from the context menu.

– or –

1. Select the desired item in the Tested Apps editor and choose Edit > Copy from the TestComplete main menu.

2. Select Edit > Paste from the main menu to paste the copied object to the editor.

After the new item appears in the tested application’s list, you can modify its properties, for example, the command-line parameters, the run mode and others.