Add a mobile device, emulator, or simulator

The Mobile Scan automatically displays the following types of devices:

• Locally connected Android or iOS devices, and emulators.

• Remote Android or iOS devices, simulators, or emulators connected through Remote (TMA).

• Android or iOS devices connected through TDC.

You can manually add iOS or Android devices, emulators, or simulators. To do so, follow these steps:

1. Start the Mobile Scan.

2. Select a connection.

3. Click Add device.

4. Into the Enter a name for your device field, enter a custom name for your mobile device.

   The Mobile Engine 3.0 uses this name as a mobile configuration name under the node Mobile > Connections.

5. Into the Enter the device ID field, enter the device ID of your mobile device.

   Tricentis Mobile Agent automatically fetches the connected devices. You can find the device ID of a locally connected Android or iOS device, emulator, or simulator by using the Tricentis Mobile Agent portal: http://localhost:8585/

   If you want Appium to dynamically select an iOS or Android device to run your mobile test, enter the value TOSCA_DYNAMIC_DEVICE_SELECTION instead of the device ID of your mobile device.

6. Select the iOS or Android radio button.

7. If you selected iOS, specify the device type:

   • Select Real for a real device.

   • Select Simulated for an iOS simulator.

8. Click Add.

   The device appears in the Mobile Scan. Additionally, the Mobile Engine 3.0 saves the manually added device in configurations, so you can use it in your TestCases.

Add a new connection

When you add iOS or Android devices, emulators, or simulators, the default connection is Local (TMA), for locally connected Android or iOS devices. You can specify a different Appium Server address on which your device is running.

To do so, follow the steps below:

1. In the Add device window, click Add New.

2. Into the Enter a name for your connection field, enter a custom name for this connection.

3. Select the connection type from the Type drop-down menu. You can choose from the following types of connections:

   • Remote (TMA) for real devices connected through USB to a remote PC running on Windows, Linux, or Mac operating system.

   

   Add connection window with Remote (TMA) connection.

   • Cloud (Appium) for cloud devices.

   

   Add connection window with Cloud (Appium) connection

   • TDC for Tricentis Device Cloud.

   

   Edit connection window with TDC connection

4. Enter the server address or the Tricentis Device Cloud token.

5. Click Add.

   The Mobile Engine 3.0 also saves the connection in mobile configurations.