Open mobile applications

To run Mobile Engine 3.0 TestCases, you must first open your application.

Use the Open Mobile App Module to open native and hybrid mobile applications on your Android or iOS device. This Module is part of the Standard subset. You can find it at Standard modules > Engines > Mobile.

When you upgrade Tricentis Tosca 12.3 or any earlier versions to 2024.2 LTS, you must perform an XEngines migration to ensure that the Open Mobile App Module works correctly. To do so, right-click on the project root element and select XEngines Migration > Update project to current version.

Use the Open Mobile App Module in a TestCase

To open a native or hybrid application on your mobile device, follow these steps:

  1. Specify the test configuration parameters to establish a connection with your device.

  2. Drag and drop the Open Mobile App Module onto your TestCase. It must be the first TestStep of your TestCase.

  3. Enter the application details depending on your device:

  4. Set the ActionMode to Input.

Specify the application for Android

For Android devices and emulators you can specify the application in one of the following ways:

Specify the full path of the application

If you use this method, the application doesn't need to be installed on your device in advance. Tricentis Tosca installs the application when you run the Open Mobile App TestStep.

In the Value field of the Application Path TestStepValue, enter the full path of the application stored on your computer. Also enter the file name of the application and the .apk extension.

Specify the PackageName and Activity

If you use this method, the application has to be already installed on your device.

In the Value fields of the AppPackage and AppActivity TestStepValues, enter the PackageName and the Activity of the application you want to steer.

Specify the application for iOS

For iOS devices and simulators you can specify the application in one of the following ways:

Specify the full path of the application

If you use this method, the application doesn't need to be installed on your device in advance. Tricentis Tosca installs the application when you run the Open Mobile App TestStep.

In the Value field of the Application Path TestStepValue, enter the full path of the application you want to steer:

  • Use the .ipa extension for a physical iOS device.

  • Use the .app extension for an iOS simulator.

Specify the BundleID of the application

If you use this method, the application has to be already installed on your device.

In the Value field of the BundleID TestStepValue, enter the BundleID of the application you want to steer.