Kobiton integration with Katalon Studio
Kobiton is a mobile device platform that offers real mobile devices for testers and developers. With Kobiton and Katalon Studio integration, you can easily execute automated tests on real mobile devices.
This article will guide you on how to integrate Kobiton with Katalon Studio and how to run Katalon automation scripts on Kobiton devices using Kobiton's desired capabilities.
From version 7.8.0 onwards, Kobiton accounts using SAML SSO login method can integrate with Katalon Studio. See Kobiton documentation on Configuring Single Sign-On/SSO and SAML with Kobiton.
Enable Kobiton integration
You have a Kobiton account.
You have installed Katalon Studio.
- Select Enable Kobiton Integration and authenticate your access to the Kobiton Server.
- From version 7.8.0 onwards: enter your Kobiton username or email, and Kobiton API Key, then select Test Connection.
- Kobiton Server: The Kobiton server to be integrated with Katalon Studio.Note:
From version 8.1.0 onwards, you can customize the remote server protocol and path name. Katalon Studio uses HTTP protocol by default. If your environment prevents sending basic authentication credentials through HTTP, you can input a remote URL with HTTPS instead.
API Key: The token to be used by Katalon Studio when exchanging API messages with Kobiton server. You can generate more keys in Kobiton API Settings.
Prior to version 7.8.0, enter your Kobiton account in the Authentication form and click Connect. Katalon Studio retrieves the information for Kobiton integration automatically.
Desired capabilities for Kobiton devices
- On the Kobiton portal, select a mobile device on which you want to run automation test. Select Automation Settings and copy the desired capabilities. You can also refer to Kobiton's documentation for this step: Getting Started with Appium Testing with Kobiton.
Here is a sample of desired capabilities for mobile device retrieved from Kobiton portal: String kobitonServerUrl = "https://katalon-integration:xxxxxxxxxxxxxxxxxxx@api.kobiton.com/wd/hub";
DesiredCapabilities capabilities = new DesiredCapabilities();
capabilities.setCapability("sessionName", "Automation test session");
capabilities.setCapability("sessionDescription", "");
capabilities.setCapability("deviceOrientation", "portrait");
capabilities.setCapability("captureScreenshots", true);
capabilities.setCapability("browserName", "chrome");
capabilities.setCapability("deviceGroup", "KOBITON");
capabilities.setCapability("deviceName", "Galaxy S10");
capabilities.setCapability("platformVersion", "12");
capabilities.setCapability("platformName", "Android"); - In Katalon Studio, open your test case and switch to the Scripts view for the automation script. Then paste the desired capabilities in your script.
- On the Kobiton portal, open your app. In the upper right corner of the app tile, select Automation Snippet. Then, copy the value of the app ID to your clipboard (for example,
kobiton-store:v488518).
Mobile testing with Kobiton devices
Install and enable the Kobiton Integration plugin. If you haven't configured the integration yet, refer to this section for instructions: Enable Kobiton integration.
- In the upper right corner of the app tile, click on the Automation Snippet. Then, copy the value of the
appcapability to your clipboard for later use (for example,kobiton-store:v488518as shown below). - Click on the Devices menu. Select your device, then select on the star icon in the top right corner to Mark as favorite.
From version 8.1.0 onwards, you can change the Custom Device Name of Kobiton device to select the correct device on Katalon Studio. If your Kobiton devices don't have any custom name, Katalon Studio uses the devices' original name when running tests. See Kobiton documentation on Device Custom Name.
Once you have set your Device Custom Names in Kobiton Portal, you can check the Kobiton devices list in Katalon Studio. Go to Katalon Studio, then open .
- In Katalon Studio, open your test case and switch to the Scripts view to see the automation test script. Locate this line of code:
Mobile.startApplication('appPath', false)Next, replace theappPathwith the Kobitonappdesired capability saved in Step 3, as shown below:
import static com.kms.katalon.core.testcase.TestCaseFactory.findTestCase
Mobile.comment('Story: Verify correct alarm message')
Mobile.comment('Given that user has started an application')'Get full directory\'s path of android application'
//def appPath = PathUtil.relativeToAbsolutePath(GlobalVariable.G_AndroidApp, RunConfiguration.getProjectDir())
Mobile.startApplication('kobiton-store:v488518', false)
Mobile.comment('And he navigates the application to Activity form')
Mobile.tap(findTestObject('Application/android.widget.TextView - App'), 10)
Mobile.tap(findTestObject('Application/App/android.widget.TextView-Activity'), 10)
Mobile.comment('When he taps on the Custom Dialog button')
Mobile.tap(findTestObject('Application/App/Activity/android.widget.TextView-Custom Dialog'), 10)
'Get displayed message on the dialog'
def message = Mobile.getText(findTestObject('Application/App/Activity/Custom Dialog/android.widget.TextViewCustomDialog'),10)
Mobile.comment('Then the correct dialog message should be displayed')
Mobile.verifyEqual(message, 'Example of how you can use a custom Theme.Dialog theme to make an activity that looks like a customized dialog, here with an ugly frame.')
Mobile.closeApplication() - From Katalon Studio main toolbar, click on the drop-down menu of Run, and select the option to run with Kobiton Device.
- The Kobiton Favorite Devices dialog appears. In the dropdown list of Device Name, select a Kobiton device to run your test and select OK. You can also modify this list by updating your Favorite Devices from Kobiton Portal.
Note:To dynamically change Kobiton devices in console mode, see Kobiton integration arguments.