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

• Prepare your iOS device

• Enable iOS simulator

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.

2. 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.

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

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

5. 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 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 version 16

For iOS devices version 16, you must perform the following steps to enable developer mode on your iOS device:

1. Select Enable Developer Mode in the Device management section.

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

3. Restart your iOS device.

   When your iOS device restarts, a pop up window appears prompting you to enable developer mode. Select Turn On to turn on developer mode.

4. Reconnect your iOS device and reopen Tricentis Mobile Agent.

Additional configuration for iOS version 17

Before you get started, make sure you have access to the following:

• Computer with Mac operating system.

• The latest version of Xcode (version 15 or higher) is installed on your computer running Tricentis Mobile Agent. You can install Xcode from the Mac App Store.

• Installed Xcode developer tools. You can install them by running the xcode-select --install command in Terminal.

You will need to manually set up WebDriverAgent to run mobile tests with iOS version 17 devices. To do so, follow these steps:

1. Navigate to http://localhost:8585/ to open the Tricentis Mobile Agent web interface.

2. Complete the additional configuration steps to use an iOS device with Tricentis Mobile Agent.

3. Start Xcode and select Settings > Accounts > Add (+) to sign in to Xcode with your Apple ID and password.

4. In Xcode, select File > Open to open a new file.

   Use the key combination Shift + Cmd + . to go to command.

   Use the key combination Shift + Cmd + G to show hidden items.

5. To set up the WebDriverAgent manually, open the WebDriverAgent project in Xcode by executing the following command in the terminal: “~/Library/Application Support/Tricentis Mobile/Agent/deps/appium/node_modules/appium-xcuitest-driver/node_modules/appium-webdriveragent” and select WebDriverAgent.xcodeproj.

6. Select the WebDriverAgent project in the left pane of Xcode to open the project settings in the editor area.

   Select the targets WebDriverAgentLib and WebDriverAgentRunner one after the other and perform the following actions for each of the targets:

   • Make sure that Automatically manage signing is selected.

   • Set the Team to your Apple Developer Team.

7. Check that your device is listed and connected. To do this, go to Window > Devices and Simulators in Xcode.

Upload iOS developer disk images

To run your iOS device (up to version 17) 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 most recent 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 appropriate 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.