Creating Mobile App Tests

Set up an Appium Configuration

Follow the steps below to create an Appium configuration in INGenious.

Click on the Configuration icon
Inside the Manage Browser tab, Enter the name of the Appium Configuation you want to create, in the Browser textbox and hit Enter
Inside the Mobile Tab, you can set your Remote URL/Appium from the textbox. By default, it is set to http://127.0.0.1:4723/
Inside the Capabilities/Options Tab, you can set your Appium Capabilities/Options
By default, automationName, deviceName, platformName and platformVersion are the required key-value pairs for Appium configuration when creating new emulators. Additional Appium configurations can be included as needed.
Click on Save button to save your Appium Configuration.

Note: Make sure you have already tested your configurations from Appium Inspector. See section Appium Inspector for more details.

Sample Android Emulator ConfigurationsSample iOS Emulator ConfigurationsSample Lambda Configurations

Sample Android Emulator INGenious Configurations

Remote URL:

createConfig

Appium Capabilities/Options:

createConfig

Sample Android Appium Capabilities Set

      {
           "deviceName": "emulator-5554",
           "automationName": "UIAutomator2",
           "platformVersion": "15.0",
           "platformName": "Android",
           "appActivity": ".MainActivity",
           "appPackage": "com.swaglabsmobileapp"
      }

Sample iOS Emulator INGenious Configurations

Remote URL:

createConfig

Appium Capabilities/Options:

createConfig

Sample iOS Appium Capabilities Set

      {
           "udid": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
           "bundleId": "com.saucelabs.SwagLabsMobileApp",
           "automationName": "XCUITest",
           "platformName": "iOS",
           "deviceName": "emulator-ios"
      }

Sample Lambda INGenious Configurations

Remote URL

Your remote url to make connection with LAMBDATEST is your connection URL with combination of your Lambda Username, Access key and extends with @mobile-hub.lambdatest.com/wd/hub

For this example, remote url is set to https://<UserName>:<AccessKey>@mobile-hub.lambdatest.com/wd/hub
To get your Username and Access Key
- Login to LAMBDATEST Portal, go to Home > Account Settings > Password & Security
- Under Username and Access Key, copy Username and Access Key as shown from example https://<UserName>:<AccessKey>@mobile-hub.lambdatest.com/wd/hub.

Appium Capabilities/Options

For this example, you can set the capabilities as below:
To get app capability
- To load application and get App Id, follow step from Lambda Official Documentaion
  - Application Setup via GUI
  - Application Setup via API
For Android Mobile in LAMBDATEST, you can use capabilities
- automatorName as UIAutomator2
- platformName as Android
- platformVersion as the Android platform version you want to use
For iOS Mobile in LAMBDATEST, you can use capabilities
- automatorName as XCUITest
- platformName as iOS
You can also add your other desired capabilities for LAMBDATEST.
- For more information related to capabilities, you can visit Desired Capabilities for LAMBDATEST
- To check capabilites, you can visit Lambda Test Automation Capabilities Generator Tool

Sample LAMBDATEST Appium Capabilities Set

      {
           "deviceName": "Galaxy S23",
           "automationName": "UIAutomator2",
           "platformVersion": "15.0",
           "platformName": "Android",
           "app": "lt://APPXXXXXXXXXXXXXXX",
           "w3c": "true",
           "language": "nl",
           "isRealMobile": "true",
           "locale": "true",
           "build": "Sample-Build-Name",
           "autoGrantPermissions": "true",
      }

Write Tests

Head over to the Design Pane of INGenious
Create Objects in the Object Repository with appropriate selectors like xpath, AccessibilityId etc. These can easily be captured from Appium Inspector
Drag and drop the objects into the test case canvas
Select appropriate actions like Tap, Scroll or Set for each relevant step

Sample Android Test CaseSample iOS Test Case

testcase

Test Execution - Design Pane

While running the test from the Design Pane, make sure to select the appropriate Appium Configuration that was created for the test. You can do that by right clicking on the Run Button and selecting the Configuration.

execution

Test Execution - Execution Pane

While running the test from the Execution Pane, make sure to select the appropriate Appium Configuration that was created for the test. You can do that by selecting the Configuration in the Browser Column.

execution