[Mobile] iOS Setup

The iOS-mobile-tests perform UI functional automation test on an iOS application using Katalon Studio.

This topic describes the preliminary actions you need to perform to prepare the environment for testing iOS applications with Katalon Studio.

Set up iOS tests on Windows and macOS

You can only test an iOS application using macOS.

Connect your iOS devices to your computer via a USB cable. Confirm to accept or trust the phone.
If you want to execute your tests using Safari on iOS (mobile browser), make sure Web Inspector is turned on for Safari (Settings > Safari > Advanced > Web Inspector).
Enable the service UI automation on the devices.
Connect the iOS devices to Xcode.
Go to Settings on the iOS devices > Developer > turn on UIAutomation.

Before diving further into testing, make sure the iOS native application file (.ipa file) is verified.

If the application file is already built and signed correctly, follow these steps:
- Open Xcode and navigate to Window/Devices.
- Choose your device from the Devices list.
- Click the "+" button and choose your application file.
If the application is not built, do as follows:
- Open the project file with Xcode tool. For example, to open Coffe Time.xcodeproj:
  
  From where you store the project > App > Your-First-iOS-App > Coffee Timer > Coffee Timer.xodeproj.
- In Xcode:
  - Select a device to launch the apps.
  - Set deployment iOS version and select device type in General/Deployment Info.
  - Build the apps by clicking Product -> Build. Wait until the build progress is finished.
    
    Make sure to select your Team in Signing & Capabilities.
  - Export the apps by clicking Product -> Archive then follow the instruction to get "Coffee Time.ipa" file.
  - Store Coffee Time.ipa file into App folder. Katalon Studio will use the exported file to start Coffee Timer application.

Once installed successfully, the application appears in the Installed Apps section, as shown below.