Tutorials

Setting up Mobile automation project in macOS

Using Katalon Studio, a tester can design mobile app automation tests for both Android and iOS to run on physical devices, cloud services or emulators.

This tutorial explains how to setup a mobile app testing project for Katalon Studio on macOS. It assumes that you are familiar with automated testing.

1. Setup Prerequisites

Katalon Studio requires the latest installation of Appium and Node.js. Please setup as the following steps:

/usr/bin/ruby -e "$(curl -fsSL
https://raw.githubusercontent.com/Homebrew/install/master/install)"
brew install carthage
  • Install node and npm with Homebrew:
brew install node

brew install npm

Note: To make sure Node.js is installed correctly, you run the command which node on Terminal.

  • Install Appium with npm
npm install -g appium
  • Set Appium Directory to “/usr/local/lib/node_modules/appium” in Katalon Preferences (from Katalon menu, go to Preferences > Katalon > Mobile)

You will need to install and configure Xcode in case of testing on iOS devices. Please set up Xcode as follows:

  • Open Xcode > Preferences > Accounts: Add developer’s Apple ID

Add-acocunt-in-Xcode

  • Open Terminal at WebDriverAgent in Appium directory folder:
    <…>/appium/node_modules/appium-xcuitest-driver/WebDriverAgent and enter following command to initialize WebDriverAgent project:
mkdir -p Resources/WebDriverAgent.bundle

sh ./Scripts/bootstrap.sh -d

  • Open project WebDriverAgent.xcodeproj under WebDriverAgent in Xcode.

Open-WebDriverAgent.xcodeproj

  • Select WebDriverAgentLib, and in the Signing section, check Automatically manage signing and select a team.

Select-target-WebDriverAgentLib

  • Then on Xcode’s menu bar, select Product > Build

Select-Build

  • Repeat the last two steps for WebDriverAgentRunner

 

  • Build WebDriverAgent to verify whether the steps above work
xcodebuild -project WebDriverAgent.xcodeproj -scheme WebDriverAgentRunner -destination 'id=<udid>' test

Note: <udid> is the device UDID of your mobile device.

  • If the following dialog is shown, select Always Allow

Always-allow

  • You should be able to see Listening on USB in the build output as below

Build-Output

2. Setup Devices

For Android devices:

  • Turn on your Android device’s developer mode (go to Settings > Developer options).
  • Connect the device to your computer via a USB cable. Just confirm if prompted for accepting/trusting the device.

For iOS devices:

  • Connect your iOS Devices to your computer via a USB cable. Just confirm if prompted for accepting/trusting the phone.
  • For iOS 8 and higher, you must enable the service UI automation on the device (connect the iOS device to Xcode) as follows:
    1. plug in the iOS device
    2. open Xcode on Mac
    3. go to Settings on the device > Developer > turn ON UIAutomation
  • For iOS 6 and higher, on your iOS device, go to Settings > Safari > Advanced and enable Web Inspector

To test an iOS native application file (.ipa or .app file), make sure the file is already built and signed properly to deploy on the device. Follow these steps to check if an application file is already built and signed correctly:
1. Open Xcode and navigate to Window/Devices
2. Choose your device from the Devices list
3. Press the “+” button and choose your application file

Choose-your-application-file

4. If installed successfully, the application will appear in the Installed Apps section as shown below

Installed-successfully

3. Desired Capabilities

You can modify extra Desired Capabilities when executing automation test in Katalon Studio.

To define Desired Capabilities for local execution using Chrome, Firefox, IE, Safari or Edge, please access Project > Settings > Execution > Default > Mobile > iOS (or Android).

The example below shows Desired Capabilities settings for Android to enable Unicode inputs.

Desired-capabilities-setting

Refer to Desired Capabilities for which properties of each web browser are supported by Selenium. For Desired Capabilities to be used with Appium, refer to Appium server capabilities.

4. External Library

You may use external libraries in your test project. Go to Project > Settings > External Libraries to add new or remove existing libraries for Katalon Studio. External libraries are stored in the Katalon Studio project’s Drivers folder.

external-Library-Katalon-Studio

  • Add: Click to add your external libraries. The selected libraries will be copied to the Katalon project’s Drivers folder.
  • Remove: Click to remove existing libraries. They will be removed from the Katalon project’s Drivers folder.

The added libraries can be imported and referenced in the Script View of Katalon Studio:

Script-view-Katalon-Studio1

thumb_up (7) thumb_down (1)

Generating reliable object selector using Spy Web utility


Katalon Studio Spy Web Utility provides an intelligent object capturing capability and immediate feedback on the uniqueness of selectors. There…

How to use synchronization commands while recording


What is Synchronization? Synchronization is a mechanism which allows multiple threads to work in parallel. In test automation, the application…

Viewing test execution reports in Katalon Analytics


Status Report Duration Report Execution Report Execution Detail View Performance and History This tutorial will show you how to leverage…
Scroll up