[Mobile] iOS Setup (Real devices) in Katalon Studio
This article shows you how to set up real iOS devices to test iOS applications with Katalon Studio.
To begin with, you need to setup a macOS environment. You can not execute iOS mobile testing in Windows or Linux.
Part 1: Install Xcode
Install Xcode version 10.2 or newer. You can download Xcode from the App Store or the Apple Developer website: Xcode 13.
Note:
- Xcode must support the current version of your iOS device.
- Katalon Studio only supports iOS version 9.0 or above.
- Katalon Studio does not officially support Xcode 14 yet. To learn more about the supported environments in Katalon Studio, see: Supported environments.
Part 2: Install Appium, Xcode command-line tools, and other iOS dependencies
Install with built-in tools
Install manually
Part 3: Set up the real iOS devices for mobile testing in Katalon Studio
Important:
- You have enrolled in the Apple Developer Program. To learn more about the Apple Developer Program enrollment, you can refer to this Apple document: Enrollment.
Part 4: Install the WebDriverAgent
The WebDriverAgent is a WebDriver server used to control iOS devices remotely. To install the WebDriverAgent, you can refer to this document: Install WebDriverAgent for iOS devices.
Part 5: Distribute your app for testing on registered devices
To distribute your app for testing on registered devices, you need to archive and export an .ipa
file. Do as follows:
Prepare your app for distribution
Create an archive of your app
To archive the
.ipa
file, click Product > Archive. If the archive builds successfully, it appears in the Archives organizer.Note:
- You can't create an archive if you set the run destination to a simulator.
Export your app using an ad hoc or development provisioning profile
Install the app on user devices
.ipa
file, follow these steps: