mobile_adaptor [TAST DokuWiki ]

User Tools

Site Tools


Sidebar

First steps in TAST

What is UML

Computer setup for TAST use

FAQ

Recognized Issues

TAST tool Menu

TAST Adaptors

Adaptors examples

TAST Integrations

Interesting features

Documentation of technical administration

Modeling recommendations

Training in the TAST tool

mobile_adaptor

This is an old revision of the document!


Mobile Adaptor

Introduction

This adapter is used to use and interact with android devices, including both physical devices and emulators.

Configuration

All the configuration needed is on the “Computer Setup for TAST use” guide.

Initialization Parameters

  • Device: Nexus7 or custom. Choose custom if you are not using Nexus as an Emulator.
  • Device Json Capabilities: Here you need to input your device Json capabilities. It is the same as the ones in Appium.
  • URL HUB: This is the URL for your hub. http://localhost:4723/wd/hub is the default.
  • URL Browser: This is where you put the URL you want to search for if you want to use a browser.
  • Validate insert values: Validates the values, checks if they are the same that were inserted.
  • Full Screenshot: To take a complete screenshot.
  • Incognito mode: To start the browser in incognito mode.

Functions

  • activateApp(App package): This function activates (brings to the foreground) the application that was specified and is not currently active, or running on the background. You specify the app package in the parameter.

  • clear(Element): Clears the value of the element.

  • clearAndType(InputElement): Clears the value of the element, and writes below.

  • clearNotificationBar:

  • click(Element): Clicks on a specific element.

  • clickLink(Element): Clicks on an element that is a link.

  • closeAllWindows(): Closes all open windows.

  • closeApp(): Closes the application.

  • countElements(Element): Counts found elements html and saves value to integer variable. The parameter is Element, with this we can indicate which part of the html the user wants to count, for example, if the user want to count the elements of the body, the body will be the parameter.

  • executeBridgeMobileCommand(Command): Executes shell ADB commands in Appium. Example: adb uninstall package.Link for useful ADB commands: https://www.inviul.com/adb-commands/. This function is recommended for advanced users.

  • executeMobileCommand(CommandName, JSONArguments): Used to execute mobile commands, like batteryInfo, or swipe, drag, etc. Allows the use of JSON Arguments.

  • getAttribute(Element, Attribute): Gets text, value or attribute of the element and saves it to a variable.

  • getNotificationText(): Obtains the notification text from the notification area. Optionally, removes notifications from this area.

  • installApp(appPath): Installs an app. The .apk must be on the specified path to your PC.

  • isAppInstalled(appId): Checks if an app is installed.

  • isExist(Element): Checks if the element exists and prints result on user log file. The input parameter Element will be the element the function has to check.

  • javascriptExecuteWithParameters(code, argument): Allows execution of custom Javascript code during the test with the values as parameters.

  • networkSettings (wifi, data, airplanemode): Establishes the network settings of the device. The parameters allow to activate or deactivate Wifi, mobile data, and airplane mode. Mobile data can only be activated or deactivated on rooted devices or emulators. Airplane mode is only working on OS 6.0 and lower.

  • openUrl(String URL): Opens the specified URL in a browser.

  • pressBack(): Presses the “Back” button on the device.

  • pressHome(): Presses the “Home” button on the device.

  • pressOverview(): Presses the “Menu” (app overview) button on the device.

  • removeApp(appId): Uninstalls the app from the device.

  • runAppInBackground:

  • scrollToElement(Element): Scrolls down or up to the specified element.

  • select:

  • sendSMS(Phone number, Text): Sends an SMS to the device. Only works on emulator.

  • startApp(appPackage, appActivity): Starts the specified app.

  • submit(Element): Clicks on the element and sends the form.

  • swipeScreen(): Swipes the screen in a direction. Accepts duration, number of times to swipe, and start and end coordinates.

  • switchToNativeApp(): Switches to Native App mode.

  • switchToWebView(): Switches to Web View mode.

  • terminateApp(identifier, JSONArguments): Closes the specified App. Accepts JSON Arguments.

  • type(InputElement): Adds the specified value to the already existing value of the element.

  • validateAttribute(Element, Attribute, Operator, Value to validate): Validates element attributes like: id, class, href, size, width, value, text … etc. Print result on user log file.

  • waitFor(Time in seconds): Waits the specified time in seconds.

  • waitForElement(Time in seconds, Element): This function waits for the specified element to appear on screen.

mobile_adaptor.1683287366.txt.gz · Last modified: 2023/05/05 11:49 by montse