Adding an iOS device (iPhone / iPad) to Suitest

Suitest supports iPhones / iPads with iOS version 13.0 or newer and iPads with iPadOS. After setting up your device you will be able to run automated end-to-end tests on iOS / iPadOS applications.

iPhones and iPads devices are operated by SuitestDrive. Before adding such device to your Suitest account, you need to pair your SuitestDrive with your Suitest organization.

To avoid any performance issues, we recommend using the newest macOS version.

To successfully add your iPhone / iPad you will need to have administration rights for the Mac host (the one running SuitestDrive and Xcode). If you do not have these rights you will have to contact your friendly system administrator to obtain them.

Preparing your iPhone / iPad

To add the device to Suitest a couple of settings in the devices system will have to be changed.

Enable UI Automation

Navigate to Settings > Developer then switch on Enable UI Automation.

Sleep settings

Navigate to Settings > General > Display & Brightness > Auto-lock and select value Never.

Installing Xcode

SuitestDrive relies on Xcode CLI tools to communicate with your device.

You can download the latest Xcode from the Apple developer website and install Xcode (11 or higher) on your Mac.

Installing Apple Configurator 2

Install Apple Configurator 2 from the Mac App Store. Once the Apple Configurator 2 is installed, choose Install Automation Tools from the app's menu in order to install the command line tool. Please see Apple Configurator 2 User Guide if necessary.

Apple Configurator 2 - Install Automation Tools

Pairing Xcode and Apple iPhone / iPad

Once you have Xcode and SuitestDrive set up on your Mac, you can proceed with pairing your Xcode with the iOS / iPadOS device (iPhone / iPad). Suitest supports devices running iOS version 13.0 or higher or iPadOS. If you are unsure about the version of your iOS / iPadOS, you can find it under Settings -> General -> About -> Version.

The pairing steps:

  1. open the Xcode on your Mac
  2. connect your iOS / iPadOS device to your Mac by a cable
  3. confirm the pop-up alert to "Trust this computer" and, if needed, enter the passcode of the device

To be sure that the device is connected correctly, open your Terminal and type instruments -s. If you see your iPhone / iPad in the output list the pairing has been successful.

Login into Xcode

Please make sure that your account is assigned to Standard Apple Developer Team. Assignment to Enterprise Apple Developer Team prevents Suitest from being able to generate a provisioning profile for your application.

Login into Xcode, to avoid a code signing issue later on. In Xcode navigate to Settings > Account then login with your developer account.

Add new account - by pressing "+"

Add the iPhone / iPad device to Suitest

Please make sure that the device UDID of your device is registered to your Apple Developer account.

Open the Device wizard, select Add physical device, choose Apple iPhone / iPad (iOS) from the platform list and then press Next.

Apple iPhone / iPad device details

  • UDID - The unique identifier of your device. If you don't know the UDID then open Xcode and navigate to Window > Devices and Simulators. From the connected section choose the device you are adding. The UDID is listed as Identifier.

  • Team Id - The Apple membership Team Id. Can be found in your Apple Developer account under Membership.

  • IP Address - Navigate to Settings > Wi-Fi and then tap on info icon of the currently connected network.

Apple iPhone / iPad Device IP Address

Fill in all the fields and press Next. SuitestDrive will now install all the dependencies, please be patient. Suitest will then verify that it can connect to your device. After verification, the iOS / iPadOS device will become available in your Suitest account.

Now that you have your iOS / iPadOS device configured, it's time to instrument your app and start testing.

Something went wrong?

Please check the Apple devices troubleshooting section for guidance.