Connect iOS mobile devices

You can connect iOS devices to the Digital Lab server, or to a connector machine.

Before you start

Before connecting devices to Digital Lab, check that your devices are supported, and remove all apps that were installed using a previous version of Digital Lab.

Note: iOS 17 is currently supported only on Mac connectors. For more details on connecting iOS 17 devices, see the prerequisites in Install the connector on a Mac machine.

Re-sign the Agent apps

The Agent apps are standard iOS applications that need to be installed on each device that you want to use with Digital Lab. These provide a communication channel between the device and Digital Lab.

The Agent apps must be re-signed with a development certificate of an Apple Developer Account, and a development provisioning profile belonging to the same account. These provide the identity of the developer, and the list of devices on which distribution of the app is allowed.

For details on how to re-sign these apps, see Re-sign the Agent apps.

Back to top

Initial device configuration

The first time that you connect a device, perform the following steps on each device you intend to connect to Digital Lab. These are one-time settings. After the initial connection has been set up, the device is "plug-and-play".

  1. In Settings > Display & Brightness > Auto-lock set the maximum time. When using a device running on iOS 12 or higher, make sure to insert a SIM card or a dummy SIM card in the device. Alternatively, set the Auto lock option to 30 seconds.
  2. Turn off automatic updates in Settings > General > Software Update.

  3. For Safari browser support: Enable JavaScript and Web Inspector in Settings > Safari > Advanced.
  4. Make sure that the Display Zoom, under the Display and Brightness settings, is set to Standard, and not Zoomed
  5. Make sure that there is an active Internet connection.
  6. Set your preferences (such as iCloud) to avoid unnecessary pop-ups.

  7. Additional steps for specific iOS versions:
  8. iOS 15 and later We recommend not setting a passcode/ TouchID/ FaceID for iOS 15 and later unless it is necessary.
    If the passcode, TouchID or FaceID is not turned off on the device, when the WebdriverAgent-runner is launched, iOS requires the user to authenticate through the security mechanism configured. This requires manual intervention with the device.
    iOS 16 and later

    Developer mode must be enabled. Developer mode is enabled automatically for devices running on iOS 16 and later. Developer mode can only be enabled automatically if there is no passcode set on the device. We recommend not setting a passcode on devices used for testing. If the device has a passcode, enable the Developer mode option in Settings > Privacy & Security > Developer Mode. For more details on developer mode, see the Apple Developer documentation.

Back to top

Connect devices to Digital Lab

If you have not already done so, make sure that you have re-signed the Agent apps with your development certificate. For details, see Re-sign the Agent apps.

Devices can be connected via USB cable to the UFT Digital Lab server or to a connector machine. For iOS devices that support cellular networks, a SIM card should be in the device. If you are connecting devices to a connector machine, see Install the connector on a Linux machine, Install the connector on a Windows machine or Install the connector on a Mac machine.

To connect a device to the UFT Digital Lab server:

  1. Connect the device to the server machine using a USB cable.
  2. Note: On some devices, when you connect the device, there may be notification, trust, or location pop-ups. Accept these pop-ups.

  3. Wait until the Agent is running on the device.
  4. If the agent does not start up on the device, verify that the devices are recognized:

Additional considerations for iOS devices

If you have not already done so, enable UI Automation on the device in Settings >Developer> Enable UI Automation. Disconnect the device, wait 5 seconds, and then reconnect it.

Back to top

Troubleshooting iOS devices

iOS device best practices

Known issues and problem solving

Back to top

See also: