Connect your iOS device to Ranorex Studio to run tests and control your apps during execution. To get started, connect the device to your computer and then add it as an endpoint in Ranorex Studio.
Before you begin, make sure you have completed the steps in Prepare your iOS device.
Choose a connection type
You can connect your iOS device to the computer where Ranorex Studio is installed using:
- USB (recommended)
- Wi-Fi
Recommendation: Use USB whenever possible. It’s typically more reliable and supports all features.
Note (network ports): Depending on your environment (especially when using Wi-Fi), make sure TCP 31000 and UDP 31000 are allowed on the computer running Ranorex Studio.
| iOS | USB | Wi-Fi |
| Create tests | ✅ | ✅ |
| Run tests | ✅ | ✅ |
| Start/stop app | ✅ | ✅ |
| Install IPA | ✅ | ❌ |
| Deploy (unattended) | ✅ | ❌ |
Connection requirements
iOS USB connection
To connect an iOS device via USB, you must install iTunes on the computer running Ranorex Studio. iTunes provides the required drivers.
General network requirements and recommendations
- Keep the device powered: Regardless of the connection type (USB/Wi-Fi), keep the device connected to a power source during test creation and execution.
- WiFi network: When connecting via Wi-Fi, the iOS device must be on the same network as the computer running Ranorex Studio.
- Avoid USB hubs: When connecting via USB, avoid USB hubs. Use your computer’s integrated USB ports if possible.
Important: The Virtual Keyboard (VK) requires the iOS software keyboard to be visually present on screen to function correctly.
Connect a device and add it as an endpoint
Note: In this example, the device is connected via USB. The process is the same when connected via WiFi.
Connect the device
- Connect the iOS device to your computer via USB.
- If the device is recognized, iTunes opens automatically
Add the device as an endpoint in Ranorex Studio
Follow the steps in Web and mobile testing > Endpoints > Add an Android/iOS endpoint