Katalon Studio Mobile Testing Tutorial

By Vijay

By Vijay

I'm Vijay, and I've been working on this blog for the past 20+ years! I’ve been in the IT industry for more than 20 years now. I completed my graduation in B.E. Computer Science from a reputed Pune university and then started my career in…

Learn about our editorial policies.
Updated January 12, 2025

How to Test Mobile Apps Using Katalon Studio:

Scripting your first mobile automation test case can be quite confusing without a specialized tool or instructions.

In this tutorial, we will show you how to speed up your automation project using Katalon Studio’s mobile recording utility and run your recorded test cases on hundreds of Kobiton’s mobile devices on a cloud.

For this tutorial, we assume that you have already installed Katalon Studio, got familiar with its basic functions and registered a Kobiton account.

How to Use Katalon Studio for Mobile App Testing

Katalon Studio Mobile Testing Tutorial

Create mobile automation test cases using Katalon Studio’s recording utility

Before we start, make sure that you have:

  • Downloaded the target app under test Material Login Demo. The app provides a set of simple authentication features that will be automated as demonstrated below
  • Configure your Katalon Studio instance for mobile testing

Katalon Studio provides two utilities to accelerate the automation process:

  • Mobile Object Spy to quickly populate the project’s object repository
  • Mobile Recorder to generate automated scripts from recorded actions

As this tutorial mainly focuses on the functionalities of the Recorder utility, if needed, refer to the Object Spy user guide available from Katalon Studio Documentation on how to use this utility.

#1) Let’s open the sample project (already included in Katalon Studio) and create a new test case. Click on the Mobile Recorder button to open its dialog as shown below.

(NOTE: Click on the image for an enlarged view)

Mobile Recorder button

#2) With the dialog open, follow the following steps to configure your recording session.

  • Plug in your device or restart your emulator then select it from the Device Name combo box
  • Click Browse to select the app file from your computer (.apk for Android and .ipa for iOS apps)
  • Click Start and wait for the app to launch on your device

Once the configuration is complete, the app will appear as shown in the screenshot above.

(Note: starting the app is registered as the first recorded action)

#3) With your app ready on your mobile device, you can start recording test cases.

i) Tap on “No account yet? Create one” to navigate to the Create Account screen.
Select the android.widget.TextView0 object in the all objects tree. (Or you can tap the text on the Device view to focus on the object).

Then click the Tap button to record the action. This action simulates a tap on the app.

Tap button

You will be directed to the Create Account screen.

ii) Fill in the information needed to create an account.

Select android.widget.EditText0 (or tap on the Name text box in the Device view to fill in a name).
Then click Set Text to perform the set text action on the Name text.

Enter “name” for the text input below. Click OK.

Create Account Screen

The text is set to the device, and the action is recorded in the Recorded action table.

iii) Perform the same steps with the Address field, and enter “address” for this field.

Address

iv) To enter the value for the email field, we will need to hide the on-screen keyboard to make the field visible by pressing the Hide Keyboard action button. Select the Email field to perform a set text action using “email@domain.com”.

v) Follow the same steps for the Mobile Number, Password and Re-enter Password text fields.

vi) Finally, click on Tap to tap on Create Account and you will be redirected to the main screen.

vii) Click Stop on the Mobile Recorder dialog to stop the recording session.

The recorded actions should look like this:

Click Stop

viii) Click OK to complete the recording and then choose a folder to store your captured objects. Click OK again for Katalon Studio to generate test scripts.

#4) View your test case in Manual mode or reply to it to validate all recorded steps. Let’s now add validation points for this test case to verify whether the recorded inputs can be set to the text fields successfully.

  • Select the first Set Text From the Add toolbar or by clicking on Add from the context menu, add a Mobile Keyword step and choose the keyword Verify Element Attribute
  • Select the test object representing the Name text field, which is a widget.EditText0, as the object to verify
  • Double click on the input cell for the test step and set the following values to validate the step of setting text to Name.
Double click on the input cell

  • Perform the same procedure for all other Set Text steps.

After adding the validation test steps, try to run the test case again. This time the execution will take longer for Katalon Studios to perform the validation steps, but your test case should pass successfully since the input value is identical to the validation value. You can test with different values or connect to a data source.

Run your mobile automation test cases with Kobiton’s cloud devices

#1) Upload the Material Login Demo app to the Kobiton App Repository. From the Repository view, select the More Actions button and select the Automation snippet Copy the app id (the one in bold, for example, Kobiton-store:184′ as shown below) and save it.

more actions button

#2) Navigate to the Kobiton Devices page. Choose the devices on which you want to run your test and mark those devices as a favorite by clicking on the star icon.

#3) Let’s enable Kobiton integration.

  • Open Katalon Studio Preferences (Windows -> Katalon Studio Preferences) then select Kobiton.
Katalon Studio Preferences

  • Enter your Kobiton username and password. Click Connect to test the connection and authentication. With a valid account, Katalon Studio automatically retrieves the API keys from Kobiton
  • Click Apply or OK to save the settings.

#4) Open the test case created from the previous section, replace the input application path for the first step “Start Application” with the Kobiton app id saved in Step 1.

#5) A new menu option appears under the Execution toolbar below. Click on Kobiton Device to open the Kobiton Favorite Device dialog.

Execution

#6) Select your target device for execution from the Favorite Device list. Click OK to start execution with that device. It may take some time to initialize the connection to Kobiton prior to the execution. You should be able to login to the Kobiton sessions to view the results once the test execution is completed.

Conclusion

The combination of Katalon Studio and Kobiton empowers automation engineers to validate the quality of mobile apps by allowing them to execute recorded test cases on hundreds of devices quickly. This solution not only saves them time but also maximizes test coverage.

=> Recommended further reading: Katalon Studio Tutorial

Katalon Studio is a FREE – a full-feature automation solution that you can download from the website. Kobiton is a cloud-based mobile device farm that provides real devices for both manual and automation testing at an affordable price.

About the Author: This is a guest post by Hieu Mai. Currently working as a senior full-stack developer for KMS Technology, Hieu Mai is one of the developers behind Katalon Studio. With 5 years’ experience in Desktop & Mobile applications development and automation testing, Hieu brings this expertise to develop Katalon Studio.

In our next article, we will discuss more on How to Get a Mobile Testing Job Fast.

Was this helpful?

Thanks for your feedback!

Recommended Reading

  • Device Testing

    Mobile Device Testing is a Process for Testing a Device for Quality. Read This Comprehensive Tutorial to Gain In-depth Knowledge About Mobile Testing: Before exploring Mobile Device Testing, let's get to know about Device Testing. Device Testing is the process by which a Device is tested for its Quality to…

  • Kobiton tutorial

    Simple Automation Testing using Kobiton: In this tutorial, we will cover simple automation with the Kobiton tool and, we will also see how to run parallel tests with Kobiton. Step by Step instructions for each step involved in the automation and execution process are explained in simple terms along with…

  • katalon studio

    This article is all about making API Testing simple with Katalon Studio. Let's get started. With the need to implement API automation tests for my projects, I have reviewed and developed proof of concept (POC) using a number of tools and testing frameworks. Honestly, it is a very challenging task…

  • Automated Fault-Tolerance Testing Using Katalon Studio

    This tutorial explains in detail about Automated Fault-Tolerance Testing Using Katalon Studio. Let's get started. Have you read the book Fail Fast, Fail Often: How Losing Can Help You Win by Ryan Babineaux and John Krumboltz? It teaches us to have a unique look at failures, know our level of tolerance…

  • mobile testing jobs and career

    In this article, we have provided a few tips on how to get a mobile testing job fast. This is an extensive mobile testing career guide for the benefit of our readers.  Part 1: You Are Here: How to Get a Mobile Testing Job FastPart 2: Mobile Testing Interview Questions…

  • Mobile Testing

    Testers often encounter five specific challenges when it comes to mobile testing. This tutorial explains the Mobile Testing Challenges and Solutions available to tackle each one. The mobile boom is obvious, and it is pretty clear they are here to stay. Smartphones are rapidly becoming the primary method of interaction…

  • Services for Mobile Beta Testing

    Beta testing is perhaps one of the most important steps in mobile application development. Unlike standardized iOS, mobile devices running on Android significantly differ from each other, not just by the installed version of the operating system, but by the type of programming language, screen resolution, hardware etc. That is…

  • Ranorex Introduction

    Here is the Ranorex Studio Hands-on Tutorial #1 (Click here for Tutorial #2). Ranorex Studio is a powerful test automation tool for everyone, including non-coders, to record automation tests step-by-step for desktop, web and mobile applications. Maintaining software quality is an important goal for any software system. In today’s world,…


6 thoughts on “Katalon Studio Mobile Testing Tutorial”

  1. This tutorial gives me the info for which i was looking. You really have helped me to know, how i can perform mobile app testing by using Katalon Studio & Kobiton’s Cloud-Based Device.

    Reply
  2. First of all I would like to thank you for giving bit knowledge on katalon, I m more curious to know about this tool, currently I m working as mobile application tester ( manual ). I will be very thankful if u share link to automate mobile apps using katalon.

    Reply
  3. While running katalon via kobiton device as described in the steps above;i am getting the below error also how to add the desired capabilities in katalon as currently it not showing in Prefences to add the same

    Test Cases/new testcase FAILED because (of) Unable to start app at: ‘kobiton-store:1119’ (Root cause: org.openqa.selenium.WebDriverException: No device matching the desired capabilities (WARNING: The server did not provide any stacktrace information)
    Command duration or timeout: 1.17 seconds
    Build info: version: ‘2.53.0’, revision: ’35ae25b’, time: ‘2016-03-15 17:00:58’

    Reply
  4. Thanks a lot for your sharing and it worked for me to learn mobile tesing very much.but I met an issue after
    setting text for password on creating account page of MaterialLoginExample, I click on hide keyboard button to hide it but failed, Some of error msg like this

    “An unknow server-side error occurred while processing the command. Original error: soft keyboard not present, cannot hide keyboard(WARNING: The server did not provide any stacktrace information)…”

    AS it is too long, I typed some of it, will be very appreciate if you can help me out.

    Reply
  5. I’ve been using Katalon Studio for 6 months. New versions and feature enhancements are released regularly. Will take a look at Kobiton soon.

    Reply

Leave a Comment