Using the Create New Project wizard you can create a new project for an existing or new project suite. On the Adobe AIR Tested Applications page of the wizard you can add AIR applications to the project’s list of tested applications.
AIR applications can be stored on the disk in two forms:
-
An executable file (.exe) and other helper files. These are applications that have been preliminarily installed from AIR installation packages (.air files).
-
A set of files, including the application descriptor file (.xml) and other helper files. Typically, these are debug versions of AIR applications that have not been packaged into AIR installation files and prepared for deployment. To run these applications, you need the AIR Debug Launcher utility that is part of the Adobe AIR SDK. The SDK is available for free download from Adobe’s web site:
TestComplete allows you to test both forms of AIR applications.
List of tested applications
The page displays a list of tested applications that has the following columns:
| Column | Description |
|---|---|
| Autorun | Specifies whether TestComplete will automatically launch the AIR tested application when you start recording a test. If this property is disabled, you will have to launch the tested application manually. You can do this by using the items of the Recording toolbar, by double-clicking the application on the desktop, by selecting the application from the All Programs menu of the operating system, or in some other ways. |
| Name | The name that will be used to address the tested application in tests. |
| File Name | The fully-qualified name of the AIR application’s executable file (.exe) or descriptor file (.xml). |
To add an application to the list
-
Click Add. This will invoke the Add AIR Application dialog.
Depending on the application type, either:
- Choose the Specify AIR application executable option and enter the path to the needed .exe file
-- or --
- Choose the Run application under AIR debugger option and specify the paths to the AIR Debug Launcher utility and the application’s descriptor file (*.xml).
- If needed, specify the command-line arguments and working folder for the AIR executable or debugger utility.
- Click OK in the Add AIR Application dialog to close it.
The applications will be added to the Tested Applications collection of your project. After you create the project, you can see the collection’s contents in the TestedApps editor.
Information about the tested application is desirable, but not required for project creation. So, you can click Finish to command TestComplete to create your project or click Next to specify the project’s scripting language. You can add more tested applications to your project any time later. See Adding Tested Applications.
To modify data in the list
To change data in the Name column, click the desired cell and enter a new value in the ensuing in-place editor. Press Enter to confirm the changes, or Esc to cancel them.
To modify the File Name value, click the ellipsis button in the corresponding cell and use the subsequent dialog. It is not allowed to enter a new File Name value manually via the in-place editor.
To remove an application from the list
-
Select the application in the list and click Remove.
About the “Record user actions over tested applications only” check box
During test recording, TestComplete records mouse clicks, dragging, keystrokes and other actions as test commands. When recording a test, you may perform some actions in applications with which your test will not interact during the test run. For instance, after you start recording, you may need to minimize the window of your e-mail client or answer an urgent IM message. TestComplete will record these actions, and during the test run it will try to find the e-mail client or IM application and repeat the recorded actions you performed. If these applications are not running during the test run or if their state differs from the one they had during recording, the test will fail.
To avoid this problem you can select the check box and thus command TestComplete to ignore the actions you perform over other applications during test recording. In this case, your test will contain only the test commands that simulate user actions over your tested applications.
Note that selecting or clearing the check box changes the Record user actions over tested applications only property of your TestComplete project.
See Also
Create New Project Wizard
Testing AIR Applications - Overview
Creating Projects and Project Suites