Execution Plan Editor - Parallel Device Cloud Environments Panel

Applies to TestComplete 15.0, last modified on October 22, 2021
Information in this topic applies to cross-platform web and mobile tests only.

About

In the Parallel Device Cloud Environments panel of the execution plan, you can configure a list of cloud remote environments where the cross-platform web or mobile tests will be run in parallel.

The Parallel Device Cloud Environments panel

Click the image to enlarge it.

If the panel is hidden, to make it visible, click the button in the right-top corner of the Execution Plan editor.

Note: You can control parallel test runs only on computers running under a 64-bit operating system.

In the panel, you can select one of the following device cloud providers:

Only one cloud can be used for a test item at a time.

CrossBrowserTesting

You can run cross-platform web tests on various environments in the SmartBear cloud.

The Parallel Device Cloud Environments panel - The CrossBrowser Testing mode

Requirements

  • TestComplete 14.4.

  • An active license for the TestComplete Web Module.

  • The Web Testing plugin and the Cross-Platform Web Testing plugin must be enabled in TestComplete (they are installed and enabled by default).

  • An active CrossBrowserTesting account.

    Note: If you do not have an account, you can sign up for a free trial directly from TestComplete — TestComplete will suggest that you do this automatically if it does not find the appropriate account data when you open the dialog.

  • TestComplete must have access to CrossBrowserTesting.com. If there are any firewalls or proxies in your network, make sure that they allow traffic from the TestComplete workstation to that website. If needed, configure the firewall to allow outbound connections on ports 80 and 443 to CrossBrowserTesting.com.

To add a new CrossBrowserTesting environment

  1. Create a cross-platform web test and add it to the execution plan.

  2. In the Device Cloud Parallel Environments panel, switch to the CrossBrowserTesting tab.
  3. In the Tested URL edit box, specify the URL of the tested web page that the specified web browser on the remote platform will open upon launching. You can specify the tested URL by using project and project suite variables.

    We recommend that you specify the complete URL of your target web page, including the protocol name. For example, http://services.smartbear.com/samples/TestComplete15/smartstore/. Otherwise, TestComplete will use the HTTPS protocol to navigate to the target web page and post a warning to the test log.

    If your tested web application is behind a firewall in your local network or on your local computer, or if you want to route traffic to your tested application through a proxy server, you can configure a secure tunnel.

    If the tunnel has not been configured yet, click Select another location and then, in the resulting Choose Your Web Application Location dialog, specify the application location.

    View instructions

    The configured tunnel will be added in the project settings.

  4. Click New Environment and specify the account credentials in the form that appeared:

    Logging in to the CrossBrowserTesting.com account

    Click the image to enlarge it.

    Click Log In on the form.

    The added credentials will be saved in the project settings. You will not input them each time.

  5. On the Parameters tab of the opened dialog, specify the following parameters of the added environments:

    Specifying environment parameters

    Click the image to enlarge it.

    Column Description
    Platform

    The browser platform on which the test will be executed. The Mobile, Desktop, and Headless platforms are available.

    Device

    The operating system on which the test will be executed.

    Browser

    The browser version in which the test will be executed.

    Resolution

    The screen resolution that will be set on the target platform for the test run.

  6. If needed, on the Custom parameters tab, you can specify additional capabilities to be used for the testing session. Specify the capabilities in the JSON format:

    Specifying custom parameters

    Click the image to enlarge it.

  7. Click OK. TestComplete will add the configured environment to the list.

    Note: The number of added environments is also displayed in the Environments column of the Test Item list for the particular test item.

BitBar Cloud

You can run mobile tests on real devices in the SmartBear cloud.

The Parallel Device Cloud Environments panel - The BitBar Cloud mode

Requirements

  • TestComplete version 14.81 and later.

  • An active license for the TestComplete Mobile module.

  • The Appium Support plugin must be enabled in TestComplete. The plugin is installed and enabled by default. You can check the plugin state in the File > Install Extensions dialog of TestComplete.

  • Mobile devices managed by Appium. A mobile device cloud provided as a service by BitBar.

    For details, please see Testing Mobile Applications - Requirements.

  • The TestComplete workstation must have access to the server that controls the mobile devices.

  • The TestComplete project must be configured to support Appium mobile devices.

    By default, all new projects are configured this way. To make sure that your project is configured correctly, check its Mobile support type property on the Properties > Mobile Devices > General page. It must be set to Mobile device cloud (BitBar and local Appium).

  • Mobile tests you want to run in parallel must be Appium-compatible. Running legacy mobile tests in parallel is not supported.

  • Mobile tests you want to run in parallel must belong to the same TestComplete project from which you will control the test runs. Running tests that belong to external projects is not supported.

To add a new BitBar environment

  1. Create a mobile test and add it to the execution plan.

  2. In the Parallel Device Cloud Environments panel, switch to the BitBar Cloud tab.
  3. Click New Environment and specify the API key assigned to your BitBar account.

    Note: If you still do not have a BitBar account, you can sign up for a free trial.

    Click OK.

  4. On the Parameters tab of the opened dialog, specify the following parameters of the added environments:

    Specifying environment parameters

    Click the image to enlarge it.

    Column Description
    Found devices

    All the devices that are available for you in BitBar and that match the search criteria. If needed, you can filter the list by using the Device Type, OS Version, Resolution and Quick Search filters. Select the device to which you want to connect.

    Application

    A mobile application for which you want to open a testing session. The application file must be either stored in the BitBar Files Library or added to the Tested Applications of the current TestComplete project. In the latter case, click Upload to BitBar to upload the application file to the BitBar Files Library and then select it in the list. .

  5. If needed, on the Custom parameters tab, you can specify additional capabilities to be used for the testing session. Specify the capabilities in the JSON format:

    Specifying environment parameters

    Click the image to enlarge it.

  6. Click OK. TestComplete will add the configured environment to the list.

    Note: The number of added environments is also displayed in the Environments column of the Test Item list for the particular test item.

Local Appium

In this mode, you can run mobile tests on an Appium server in your local network.

The Parallel Device Cloud Environments panel - The Local Appium mode

Requirements

  • TestComplete version 14.81 and later.

  • An active license for the TestComplete Mobile module.

  • The Appium Support plugin must be enabled in TestComplete. The plugin is installed and enabled by default. You can check the plugin state in the File > Install Extensions dialog of TestComplete.

  • Mobile devices managed by Appium. A private server managed by the Appium framework. It can run on your current computer or on a remote computer in your local network. The supported Appium version is 1.18.2. To learn how to install and configure one, please see Set up Appium Server.

  • The TestComplete workstation must have access to the server that controls the mobile devices.

  • The TestComplete project must be configured to support Appium mobile devices.

    By default, all new projects are configured this way. To make sure that your project is configured correctly, check its Mobile support type property on the Properties > Mobile Devices > General page. It must be set to Mobile device cloud (BitBar and local Appium).

  • Mobile tests you want to run in parallel must be Appium-compatible. Running legacy mobile tests in parallel is not supported.

  • Mobile tests you want to run in parallel must belong to the same TestComplete project from which you will control the test runs. Running tests that belong to external projects is not supported.

To add a new Appium environment

  1. Create a mobile test and add it to the execution plan.

  2. In the Parallel Device Cloud Environments panel, switch to the Local Appium tab.
  3. Click New Environment.

  4. On the Parameters tab of the opened dialog, specify the following parameters of the added environments:

    Specifying environment parameters

    Click the image to enlarge it.

    Column Description
    Server URL

    The URL address of your Appium server

    Application Path

    The full path to the application that you want to install on the target mobile device and from which you want to open a testing session. You can type the path manually, or you can click the ellipsis button and browse for the needed application file.

    Parameters

    The capabilities that describe a testing session you want to open, in the JSON format. The dialog will validate the JSON code as you are typing.

    View required capabilities

  5. Click OK. TestComplete will add the configured environment to the list.

    Note: The number of added environments is also displayed in the Environments column of the Test Item list for the particular test item.

Working with the list of environments

Edit the list of environments

To edit the environment, click the button in the right corner of the particular environment.

To remove the environment from the list, click in the right corner of the particular environment.

Save the list of environments to an external file

  1. Click Export to file in the Parallel Device Cloud Environments panel.

  2. In the subsequent dialog, specify the name and location of the .xml file that will store the list of environments.

  3. Click Save.

Load the list of environments from an external file

  1. Click Load from file in the Parallel Device Cloud Environments panel.

  2. In the subsequent dialog, specify the .xml file containing the list of environments.

  3. Click Open. TestComplete will load the list of environments from the specified file.

See Also

Tests, Test Items, and Test Cases
Running Cross-Platform Web Tests in Parallel
Running Mobile Tests in Parallel
Running Tests
About Cross-Platform Web Tests

Highlight search results