TAST DokuWiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== 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 [[en:“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**: Clears messages from the notifications bar. Optional Xpath parameter to clean button.\\ \\ 
  * **click(Element):** Click on a specific element.\\ \\ 
  * **clickLink(Element):** Click on an element that is a link.\\ \\ 
  * **closeAllWindows():** Close all open windows.\\ \\ 
  * **closeApp():** Close 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):** Run ADB shell commands on Appium (e.g. adb uninstall package). Link to useful ADB commands: https://www.inviul.com/adb-commands/. This function is recommended for advanced users.\\ \\ 
  * **executeMobileCommand(CommandName, JSONArguments):** It is used to execute mobile commands, such as batteryInfo, swipe, drag, etc. Allows the use of JSON arguments.\\ \\ 
  * **getAttribute(Element, Attribute):** Receives the text, value or attribute from the element and stores it in a variable.\\ \\  
  * **getNotificationText():** Gets the notification text from the notification area. Optionally, remove notifications from this area.\\ \\ 
  * **installApp(appPath):** Install an application. The specified .apk file must be a path on your PC.\\ \\ 
  * **isAppInstalled(appId):** Checks if an application 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 the execution of custom Javascript Code during the test, with the values as parameters.\\ \\  
  * **networkSettings (wifi, data, airplanemode):** Sets the network configuration of the device. The settings allow you to enable or disable Wifi, data and airplane mode. Data can only be enabled and disabled on rooted devices or emulators. Airplane mode only works on OS 6.0 and below.\\ \\ 
  * **openUrl(String URL):** Opens the specified URL in a browser.\\ \\ 
  * **pressBack():** Press the back button on the device.\\ \\ 
  * **pressHome():** Press the “Home” button on the device.\\ \\ 
  * **pressOverview():** Press the “Menu” button (application overview) on the device.\\ \\ 
  * **removeApp(appId):** Uninstall the specified application from the device.\\ \\ 
  * **runAppInBackground:** Run the application in the background.\\ \\ 
  * **scrollToElement(Element):** Scrolls up or down to the specified element.\\ \\ 
  * **select**:\\ \\
  * **sendSMS(Phone number, Text):** Sends an SMS to the device. Only works in emulator.\\ \\ 
  * **startApp(appPackage, appActivity):** Starts the specified application.\\ \\ 
  * **submit(Element):** Click on the element and submit the form.\\ \\ 
  * **swipeScreen():** Drag the screen in one direction. Accepts duration, number of times to drag, and start and end coordinates.\\ \\ 
  * **switchToNativeApp():** Switches to Native App mode.\\ \\ 
  * **switchToWebView():** Switches to Web View mode.\\ \\ 
  * **terminateApp(identifier, JSONArguments):** Closes the specified application. Accepts JSON arguments.\\ \\ 
  * **type(InputElement):** Adds the written 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):** Wait the specified time in seconds.\\ \\ 
  * **waitForElement(Time in seconds, Element):** This function waits for the specified item to appear on the screen.\\ \\
TAST DokuWiki

User Tools

Site Tools

Page Tools
