Connect and configure your devices

Once you've installed Tricentis Mobile Agent, you must connect and configure your devices. Tricentis Mobile Agent detects all the connected devices and lists them under Device management. You can view your connected devices, manage their settings, upload iOS developer disk images to iOS devices, and delete an iOS image from iOS devices in the Device management section. To view the screen of a connected device, click the screen mirroring button next to the connected device in the Device management section.

To connect and configure your device, follow the respective instructions:

Prepare your Android device

To prepare your Android device for test automation with Tricentis Mobile Agent, follow these steps:

  1. Connect your Android device to your computer and allow access to your phone data.

  1. To enable developer mode on your Android device, go to Settings > About phone > Software information and tap on the Build number 7 times.

    The Developer options is now visible under Settings.

  1. To enable USB debugging, go to Settings > Developer options and enable USB debugging.

  1. To prevent your Android device from going into sleep mode during your tests, enable Stay awake.

  1. Ensure that the USB driver for the device is installed on your computer. For information on how to install the driver, see this Tricentis Knowledge Base article.

Connect your Android device via Wi-Fi

Before you connect your Android device via Wi-Fi, make sure you've installed Tricentis Mobile Agent. To run test recordings via Wi-Fi, you need to connect your Android device to your Tricentis Mobile Agent account. To do so, follow these steps:

  1. Connect your Android device to the computer via USB cable.

  2. Open Command Prompt and go to the installation folder: cd C:\Program Files\Tricentis\Mobile Agent\app\android-sdk\platform-tools

  3. Run these commands in the following order:

    1. adb start-server

    2. adb tcpip 5555

    3. adb shell "ip addr show wlan0 | grep -e wlan0$ | cut -d\" \" -f 6 | cut -d/ -f 1"

      You now have the IP address of your Android device.

    4. adb connect <ip_address>:5555

      Replace <ip_address> with the IP address of your Android device.

Your Android device is now connected via Wi-Fi, safely remove and unplug your device.

Prepare your iOS device

Prerequisites

Before you prepare your iOS device for test automation, make sure to perform the following actions:

  • On your iOS device, navigate to Settings > General > Device Management and remove any policies that are listed.

  • Turn off the passcode or PIN.

  • Deactivate auto-lock.

  • Enable USB Accessories.

To prepare your iOS device for test automation with Tricentis Mobile Agent, follow these steps:

  1. Connect your iOS device to your computer.

    For iOS version 16, you must enable the developer mode on your iOS device.

  2. On your iOS device, go to Settings and perform the following actions:

    • To enable UI automation on your iOS device, go to Privacy & Security > Developer settings and select Enable UI automation.

    • To enable web inspector on your iOS device, go to Safari > Advanced and enable Web Inspector.

Additional configuration for iOS 16

For iOS 16 devices, you need to enable the developer mode:

  1. In the Device Management section of Tricentis Mobile Agent, select Enable Developer Mode.

  2. On your iOS device, go to Settings > Privacy & Security > Developer Mode and enable Developer Mode.

  3. Restart your iOS device.

    After restarting, a pop-up window prompts you to enable developer mode. Select Turn On.

  4. Reconnect the iOS device to your computer.

  5. Launch Tricentis Mobile Agent again.

Additional configuration for iOS 17

Make sure you have a MacOS computer that runs Tricentis Mobile Agent and install the following software components:

To run mobile tests with Tricentis Mobile Agent 2024.1, follow these steps:

  1. Go to http://localhost:8585/ to access the Tricentis Mobile Agent web interface.

  2. Complete the additional configuration steps for iOS devices.

Your setup is successful if your device is listed and connected under Window > Devices and Simulators.

Make sure you have a MacOS computer that runs Tricentis Mobile Agent and install the following software components:

To run mobile tests with Tricentis Mobile Agent 2023.7 or older versions, you need to manually set up the WebDriverAgent:

  1. Go to http://localhost:8585/ to access the Tricentis Mobile Agent web interface.

  2. Complete the additional configuration steps for iOS devices.

  3. Open the Terminal application and run this command to open the directory that contains the WebDriverAgent.xcodeproj file:

    open ~/"Library/Application Support/Tricentis Mobile/Agent/deps/appium/node_modules/appium-xcuitest-driver/node_modules/appium-webdriveragent/"

  1. Open the WebDriverAgent.xcodeproj file with Xcode.

  2. In Xcode, select the Project navigator.

  3. Choose the WebDriverAgentRunner target.

  4. On the Signing & Capabilities tab, select the Automatically manage signing checkbox.

  5. Set your Team to your Apple Developer Team.

Your setup is successful if your device is listed and connected under Window > Devices and Simulators.

Upload iOS developer disk images

iOS 17 doesn't require uploading any iOS developer disk image.

To run your iOS device in developer mode and install the WebDriverAgent (WDA) with development certificate, you need an iOS developer disk image.

If you use a Mac operating system, make sure you have the latest version of Xcode. Then, navigate to /Applications/XCode.app/Contents/Developer/Platforms/iPhoneOS.platform to find the iOS developer disk images.

If you use a different operating system, contact the Tricentis Support Hub to request the iOS developer disk images.

To upload an iOS image, follow these steps:

  1. Under Device Management, select Upload iOS image.

  2. Choose the iOS image with the corresponding iOS version.

  3. Select Upload.

Get Apple team ID

You need an Apple team ID to automate the iOS device connected to your computer. The Apple team ID is a unique 10-character string that Apple generates to identify your team.

You can find your Apple team ID in the Membership section of your Apple Developer Account. For information on how to get your Apple team ID, see the Apple online help.

After you connect and configure your iOS device, you must perform additional configuration steps in Tricentis Mobile Agent.

Enable iOS simulator

To enable iOS simulators on Mac, use the simulator app available within Xcode. Interact with an iOS simulator using a keyboard or a mouse. To mirror an iOS simulator using Tricentis Mobile Agent, you don't need an Apple developer account.

To enable iOS simulators on Mac for test automation with Tricentis Mobile Agent, follow these steps:

  1. Install and start Tricentis Mobile Agent on Mac.

  2. Install Xcode from the Mac App Store.

  3. To select and start an iOS simulator available within Xcode, follow the steps in the Apple Simulator User Guide.

What's next

Find out how to run your mobile tests in Tricentis Tosca or Testim.