Test Host applications

Ready to create Host application tests? Then this topic is for you. It explains the most important steps to your first Host test case.

Supported versions

For information on supported versions, check out the system requirements.

If you're using a Host emulator that's not supported, don't worry. You may still be able to run tests using headless execution, which doesn't require the emulator installed on your client machine.

Create Host test cases

To create a stable, effective set of tests, you need to create stable, effective test cases.

Before you start

Before you start creating your test cases, make sure you meet the following requirements:

  • Your emulator session has a short name. Most emulators automatically assign short names to sessions, but we recommend that you double-check the session settings of your emulator.

  • The path to the folder, which contains the emulator-specific DLL(s), is included in the Path system variable.

Create your test case

Creating Host application test cases is easy:

  1. Open your application under test.

  2. Scan your application to create modules. A module is the technical representation of a specific part of your application. It contains all necessary technical information that Tosca Cloud needs to find and steer elements of your application.

  3. Create a new, empty test case.

  4. Design your test case to build an automated test sequence. You can add the following design elements to your test case:

    • All elements we list in the design topic, such as the modules you created by scanning or standard modules. Standard modules are pre-built modules for common tasks that Tosca Cloud provides out of the box.

    • Standard modules specifically for steering Host applications. You can find these modules under > Modules.

  5. To set up your test case for headless execution, add the following parameters: 

    • HostEnableHeadlessExecution with the value True.

    • HostName with your Host server's IP address as the value.

    • HostPort with your Host server's port as the value.

    • [Optional] HostTimeout with the desired timeout in milliseconds, to define the maximum allowed time for communication between Tosca Cloud and your Host server. If you don't specify otherwise, timeouts occur after 40000 milliseconds.

Work with Host controls

A control is a screen element in your application under test. For example, a button, text box, menu entry, or table cell. And when you use a module in your test case, you need to tell Tosca Cloud what to do with these controls.

For information on supported controls for Host applications, check out Host controls.

What's next

You've just created your first Host test case. Well done!

Next up: do a test case trial run. Trial runs help you find and fix issues, so you can make your tests as stable and reliable as possible.

Once you're happy with your test case, pack it into a playlist, so you can run your tests in earnest.