btac.sa.lib

Class MobileCommonMethods

java.lang.Object

btac.sa.lib.MobileCommonMethods

public class MobileCommonMethods
extends Object

The Class MobileCommonMethods.

Field Summary

Fields

Modifier and Type	Field and Description
static io.appium.java_client.AppiumDriver	driver The driver.
static int	sleepTimeAverage The sleep time average.
static int	sleepTimeAverage2 The sleep time average2.
static int	sleepTimeMax The sleep time max.
static int	sleepTimeMax2 The sleep time max2.
static int	sleepTimeMin The sleep time min.
static int	sleepTimeMin2 The sleep time min2.

Constructor Summary

Constructors

Constructor and Description
MobileCommonMethods()

Method Summary

Modifier and Type	Method and Description
static void	callingImplicitSleep() Webdriver implicit sleep.
static void	clearField(org.openqa.selenium.By by) Clear field content.
static void	clickElementAtIndex(org.openqa.selenium.By byElementLocator, int index) Select an element at specific index and clicks on it.
static void	clickElementsPresentWithSameLocatorAtDiffIndex(org.openqa.selenium.By elementLocator, org.openqa.selenium.By expectedPageTitleLocator, org.openqa.selenium.By basePageUniqueElementLocator) Elements at different index with same locator is clicked to check what exactly it opens.
static int	countElementsPresentWithSameLocator(org.openqa.selenium.WebDriver driver, org.openqa.selenium.By by) Checks if element is present in current screen of mobile device for the locator passed.
static org.openqa.selenium.Point	getCenter(org.openqa.selenium.By byElementLocator) Gets the center.
static List<org.openqa.selenium.WebElement>	getElementsPresentForSameLocator(org.openqa.selenium.WebDriver driver, org.openqa.selenium.By by) Gets all the elements present for the locator passed.
static void	initializeSleepTimings() Initialize all sleep timings variables.
static Boolean	isElementDisplayed(org.openqa.selenium.By byElementLocator) Checks if element is displayed or not.
static boolean	isElementPresent(org.openqa.selenium.WebDriver driver, org.openqa.selenium.By by) Checks if element is present on the current screen.
static void	launchEmulatorAndroidApp(String appName) Launch emulator android app.
static void	launchEmulatorAndroidAppViaLocalAPKPath(String localSysApkPath) Launch emulator and installs android app via local system APK path and then launches the App directly.
static void	launchEmulatorAndroidBrowser() Launch emulator android browser.
static void	launchRealAndroidApp(String appName) Launch app based on appName.
static void	navigateBack() Navigate back: Navigates to previous page.
static void	quitApp(org.testng.ITestResult result) Quits app + driver + takes screenshot of the page where failure occurred(if any). Screenshot is saved @..projectRootDirectory/failure_screenshots/
static void	screenshotMobile(String methodName) Screenshot mobile. Stored within "failure_Screenshot" folder with File name format: methodName_dd_MM_yyyy_hh_mm_ss.png Ex: loginCheck_28_10_2015_07_10_10.png
static void	scrollFindAndClickOnElement(org.openqa.selenium.By byElementLocator, int repeatSwipe) Find and click on element.
static void	scrollToAndClickOnElement(String elementName) Scroll to and click on element.
static void	sendKeyEvent(String keyEvent) Customized Appium Send key event Pass the exact parameter name which exists in config.properties file within "Android Key Event properties" section
static void	swipe(double xStart, double yStart, double xEnd, double yEnd, int swipeTime, int totalSwipes) Custom Swipe method for Appium.
static void	swipeDown(int swipeTimeInMilliSecs, int swipeRepeat) Swipe down.
static void	swipeUp(int swipeTimeInMilliSecs, int swipeRepeat) Swipe up.
static void	waitForElementToBeClickable(org.openqa.selenium.By by, int seconds) Waits for desired Seconds for the element to be Clickable.
static void	waitForElementToBeSelected(org.openqa.selenium.By by, int seconds) Waits for desired Seconds and then checks for the element to be Selected.
static void	waitingForTheElementToLoad(org.openqa.selenium.By by, int seconds) Waits for desired seconds and then checks if the element is visible or not.
static void	waitSeconds(int seconds) Wait seconds.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

driver

public static io.appium.java_client.AppiumDriver driver

The driver.

sleepTimeMin

public static int sleepTimeMin

The sleep time min.

sleepTimeMin2

public static int sleepTimeMin2

The sleep time min2.

sleepTimeAverage

public static int sleepTimeAverage

The sleep time average.

sleepTimeAverage2

public static int sleepTimeAverage2

The sleep time average2.

sleepTimeMax

public static int sleepTimeMax

The sleep time max.

sleepTimeMax2

public static int sleepTimeMax2

The sleep time max2.

Constructor Detail

MobileCommonMethods

public MobileCommonMethods()

Method Detail

launchRealAndroidApp

public static void launchRealAndroidApp(String appName)
                                 throws Exception

Launch app based on appName. This will assist to launch multiple app with different appPackage/appActivity capabilities within same test script scope

Ex:"flipkart". This App name passed will concat with AppPackage/AppActivity string. The resulting string variable value is retrieved from config.properties file and will automatically launch the app/driver session

Parameters:

appName - the app name. Ex:"flipkart" or"fk" or anything which is exactly same as variable name in config.properties file

Throws:

Exception - the exception

launchEmulatorAndroidAppViaLocalAPKPath

public static void launchEmulatorAndroidAppViaLocalAPKPath(String localSysApkPath)
                                                    throws Exception

Launch emulator and installs android app via local system APK path and then launches the App directly.

Parameters:

localSysApkPath - the local sys apk path.
Ex for windows: "D:/Softwares/workspacePersonal/com.flipkart.android-4.2-APK4Fun.com.apk"
Ex for mac: "/Users/username/Softwares/workspacePersonal/com.flipkart.android-4.2-APK4Fun.com.apk"

Throws:

Exception - the exception

launchEmulatorAndroidApp

public static void launchEmulatorAndroidApp(String appName)
                                     throws Exception

Launch emulator android app. This will assist to launch multiple app with different appPackage/appActivity capabilities within same test script scope

Ex:"flipkart". This App name passed will concat with AppPackage/AppActivity string. The resulting string "fkAppPackage/fkAppActivity" variable value is retrieved from config.properties file and will automatically launch the app/driver session

Parameters:

appName - the app name. Ex:"flipkart" or"fk" or anything which is exactly same as variable name in config.properties file

Throws:

Exception - the exception

launchEmulatorAndroidBrowser

public static void launchEmulatorAndroidBrowser()
                                         throws Exception

Launch emulator android browser.

Throws:

Exception - the exception

screenshotMobile

public static void screenshotMobile(String methodName)
                             throws Exception

Screenshot mobile.
Stored within "failure_Screenshot" folder with File name format: methodName_dd_MM_yyyy_hh_mm_ss.png
Ex: loginCheck_28_10_2015_07_10_10.png

Parameters:

methodName - the method name

Throws:

Exception - the exception

waitSeconds

public static void waitSeconds(int seconds)
                        throws Exception

Wait seconds.

Parameters:

seconds - the seconds

Throws:

Exception - the exception

waitingForTheElementToLoad

public static void waitingForTheElementToLoad(org.openqa.selenium.By by,
                                              int seconds)
                                       throws Exception

Waits for desired seconds and then checks if the element is visible or not.

Parameters:

by - Pass the element as By.xpath / By.Id / By.Name or any other locator type supported with By

Throws:

Exception - the exception

waitForElementToBeSelected

public static void waitForElementToBeSelected(org.openqa.selenium.By by,
                                              int seconds)
                                       throws Exception

Waits for desired Seconds and then checks for the element to be Selected.

Parameters:

by - Pass the element as By.xpath / By.Id / By.Name or any other locator type supported with By

Throws:

Exception - the exception

waitForElementToBeClickable

public static void waitForElementToBeClickable(org.openqa.selenium.By by,
                                               int seconds)
                                        throws Exception

Waits for desired Seconds for the element to be Clickable.
Sometimes an element/button is inactive/greyed out and can't be interacted with it. So, it waits for specified seconds and checks again if element is clickable or not.

Parameters:

by - Pass the element as By.xpath / By.Id / By.Name or any other locator type supported with By

Throws:

Exception - the exception

callingImplicitSleep

public static void callingImplicitSleep()
                                 throws Exception

Webdriver implicit sleep. Waits for seconds specified in "implicitWaitTime" key from config.properties file

Throws:

Exception - the exception

initializeSleepTimings

public static void initializeSleepTimings()
                                   throws IOException,
                                          Exception

Initialize all sleep timings variables. Method is used for Project internal purpose.

Throws:

IOException - Signals that an I/O exception has occurred.

Exception

isElementPresent

public static boolean isElementPresent(org.openqa.selenium.WebDriver driver,
                                       org.openqa.selenium.By by)
                                throws Exception

Checks if element is present on the current screen. Returns true/false if element is present/not present

Parameters:

driver - the driver

by - Pass the element as By.xpath / By.Id / By.Name or any other locator type supported with By

Returns:

True, if is elements present. False, if not present

Throws:

Exception - the exception

isElementDisplayed

public static Boolean isElementDisplayed(org.openqa.selenium.By byElementLocator)

Checks if element is displayed or not.

Parameters:

byElementLocator - the by element locator

Returns:

the boolean

countElementsPresentWithSameLocator

public static int countElementsPresentWithSameLocator(org.openqa.selenium.WebDriver driver,
                                                      org.openqa.selenium.By by)
                                               throws Exception

Checks if element is present in current screen of mobile device for the locator passed. Returns the count of such elements for that same locator.

Parameters:

driver - the driver

by - Pass the element as By.xpath / By.Id / By.Name or any other locator type supported with By

Returns:

the size of elements(in int) found for the locator passed. Returns zero if no such element found.

Throws:

Exception - the exception

getElementsPresentForSameLocator

public static List<org.openqa.selenium.WebElement> getElementsPresentForSameLocator(org.openqa.selenium.WebDriver driver,
                                                                                    org.openqa.selenium.By by)
                                                                             throws Exception

Gets all the elements present for the locator passed.

Parameters:

driver - the driver

by - Pass the element as By.xpath / By.Id / By.Name or any other locator type supported with By

Returns:

all the elements present for the locator, which can be used later to interact via loop or individual index value

Throws:

Exception

clickElementsPresentWithSameLocatorAtDiffIndex

public static void clickElementsPresentWithSameLocatorAtDiffIndex(org.openqa.selenium.By elementLocator,
                                                                  org.openqa.selenium.By expectedPageTitleLocator,
                                                                  org.openqa.selenium.By basePageUniqueElementLocator)
                                                           throws Exception

Elements at different index with same locator is clicked to check what exactly it opens.

Parameters:

elementLocator - the element locator which is ambiguous on BasePage

expectedPageTitleLocator - the expected BasePage title locator. Checks if control is still on same BasePage after clicking.

basePageUniqueElementLocator - the base page unique element locator for assert purpose. Ex:'By.name(hamburgerName)'

Throws:

Exception - the exception

clickElementAtIndex

public static void clickElementAtIndex(org.openqa.selenium.By byElementLocator,
                                       int index)
                                throws Exception

Select an element at specific index and clicks on it.
Locator value might be ambiguous on the page(Array of elements with same locator) and hence element can be identified via unique Index value.

Parameters:

byElementLocator - the by element locator."By.className(String className)"

index - the index

Throws:

Exception - the exception

clearField

public static void clearField(org.openqa.selenium.By by)
                       throws Exception

Clear field content.

Parameters:

by - the by. Ex: "By.className(String className)"

Throws:

Exception

sendKeyEvent

public static void sendKeyEvent(String keyEvent)
                         throws Exception

Customized Appium Send key event
Pass the exact parameter name which exists in config.properties file within "Android Key Event properties" section

Parameters:

keyEvent - the key event. Ex: "backspaceKeyEvent" variable which exists in config.properties file

Throws:

Exception

navigateBack

public static void navigateBack()
                         throws Exception

Navigate back: Navigates to previous page.

Throws:

Exception - the exception

getCenter

public static org.openqa.selenium.Point getCenter(org.openqa.selenium.By byElementLocator)
                                           throws Exception

Gets the center.

Parameters:

byElementLocator - the by element locator. Ex: "By.className(String className)"

Returns:

the center(Datatype - Point)

Throws:

Exception - the exception

swipe

public static void swipe(double xStart,
                         double yStart,
                         double xEnd,
                         double yEnd,
                         int swipeTime,
                         int totalSwipes)
                  throws IOException,
                         Exception

Custom Swipe method for Appium. Helps for Device fragmentation when screen resolutions are different.
Keeps swiping the screen from start to end location for N times

Parameters:

xStart - the x start coordinates

yStart - the y start coordinates

xEnd - the x end coordinates

yEnd - the y end coordinates

swipeTime - the sweep time

totalSwipes - the total swipes

Throws:

IOException - Signals that an I/O exception has occurred.

Exception - the exception

swipeUp

public static void swipeUp(int swipeTimeInMilliSecs,
                           int swipeRepeat)
                    throws InterruptedException

Swipe up.

Parameters:

swipeTimeInMilliSecs - the swipe time in milli secs

swipeRepeat - the number of times 'swipe up' repeat

Throws:

InterruptedException - the interrupted exception

swipeDown

public static void swipeDown(int swipeTimeInMilliSecs,
                             int swipeRepeat)
                      throws InterruptedException

Swipe down.

Parameters:

swipeTimeInMilliSecs - the swipe time in milli secs

swipeRepeat - the number of times 'swipe down' repeats

Throws:

InterruptedException - the interrupted exception

scrollToAndClickOnElement

public static void scrollToAndClickOnElement(String elementName)
                                      throws Exception

Scroll to and click on element.
Faster than 'scrollFindAndClickOnElement()' but doesn't work if Element locator is not of type 'text'/'name'.

Parameters:

elementName - the element name

Throws:

Exception - the exception

scrollFindAndClickOnElement

public static void scrollFindAndClickOnElement(org.openqa.selenium.By byElementLocator,
                                               int repeatSwipe)
                                        throws Exception

Find and click on element.
Step 1: If Element is not found then do 'Swipe Up' and try again to find element.
Step 2: Repeat step 1 process until element is found. Worst case, repeat 'Swipe and Find' process for limit specified by 'repeatSwipe'

As compared to 'scrollToAndClickOnElement()' works for all kinds of By Locator. But, starts swiping screen from current till end of page. Hence, if the element is above current screen then it won't find the element.

Parameters:

byElementLocator - the by element locator. Ex: "By.className(String className)"

repeatSwipe - Total swipe to be done. Tries to find an element after Swipe is done each time.

Throws:

Exception - the exception

quitApp

public static void quitApp(org.testng.ITestResult result)
                    throws Exception

Quits app + driver + takes screenshot of the page where failure occurred(if any).
Screenshot is saved @..projectRootDirectory/failure_screenshots/

Parameters:

result - the result. Ex: "ITestResult result". This needs TestNG Jar to work.

Throws:

Exception