Testing Mobile Applications - Prerequisites

Applies to TestComplete 15.47, last modified on January 20, 2023

Before you start creating and running mobile tests with TestComplete, you may need to prepare TestComplete and your testing environments to make sure that the test engine is able to access your tested application:

If you use BitBar

1. Get the API Key

To access the BitBar mobile cloud from TestComplete tests, use the API key assigned to your BitBar account:

  1. Log in to BitBar with your BitBar account.

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

  2. Click  > My Account at the top right of the page.

  3. In the My Integrations section, click API.

  4. On the resulting page, click to copy your API key to the clipboard.

Copying the BitBat API key

Click the image to enlarge it.

2. Upload the tested app and get the app ID

To open a testing session on a mobile device in a cloud, specify the ID of the application for which the session will be opened. To get the ID, upload the application file (.apk or .ipa) to the BitBar Files Library:

Via the BitBar website
  1. Log in to BitBar using your BitBar account.

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

  2. Click My Files Library on the top of the page.

  3. Click Upload file and browse for the application file you want to upload. For iOS, it must be an .ipa file. For Android, it must be an .apk file.

  4. After the file is uploaded, you can view its ID in the info panel at the bottom:

    Getting the application ID

    Click the image to enlarge it.

From the TestComplete IDE
  1. Open the TestComplete project that you will use to run tests in the mobile device cloud.

  2. Add the application file to the Tested Applications collection of the project.

  3. Select the application in the Tested Applications collection and click Upload to BitBar:

    Uploading a mobile application to the BitBar Files Library from the Tested Applications collection

    Click the image to enlarge it.

  4. When generating code to open a testing session via the Generate Run Code dialog, in the Application drop-down list, select the application in the list.

    If the application is not uploaded to the BitBar Files Library yet, click Upload and select:

    Uploading a mobile application to the BitBar Files Library from the Generate Run Code dialog

    Click the image to enlarge it.

    If the application is already uploaded, click Select.

    Getting the app ID in the Generate Run Code dialog

    Click the image to enlarge it.

    The dialog will add the application ID to the generated code that will open a testing session:

    App ID in the generated code

    Click the image to enlarge it.

If you use private mobile devices

  • If needed, configure a private Appium server to manage your mobile devices. See Set up Appium Server.

  • Place your tested application to a location available to your mobile devices. For example, you can place the application file (.apk, .app or .ipa) to a shared network location.

    To install the application to the target device, use the app capability. You may want to add the tested application to the Tested Applications collection of your TestComplete project to manage it easier. For information on how to install the application upon opening a testing session, see Connecting to Mobile Devices and Opening Testing Sessions.

See Also

Testing Mobile Applications

Highlight search results