io.appium.java_client.android

Class AndroidDriver

java.lang.Object

org.openqa.selenium.remote.RemoteWebDriver

io.appium.java_client.AppiumDriver

io.appium.java_client.android.AndroidDriver

All Implemented Interfaces:

AndroidDeviceActionShortcuts, HasAppStrings, HasNetworkConnection, PushesFiles, StartsActivity, DeviceActionShortcuts, FindsByAccessibilityId, FindsByAndroidUIAutomator, InteractsWithApps, InteractsWithFiles, MobileDriver, PerformsTouchActions, ScrollsTo, TouchShortcuts, org.openqa.selenium.ContextAware, org.openqa.selenium.HasCapabilities, org.openqa.selenium.html5.LocationContext, org.openqa.selenium.interactions.HasInputDevices, org.openqa.selenium.internal.FindsByClassName, org.openqa.selenium.internal.FindsByCssSelector, org.openqa.selenium.internal.FindsById, org.openqa.selenium.internal.FindsByLinkText, org.openqa.selenium.internal.FindsByName, org.openqa.selenium.internal.FindsByTagName, org.openqa.selenium.internal.FindsByXPath, org.openqa.selenium.JavascriptExecutor, org.openqa.selenium.Rotatable, org.openqa.selenium.SearchContext, org.openqa.selenium.TakesScreenshot, org.openqa.selenium.WebDriver

public class AndroidDriver
extends AppiumDriver
implements AndroidDeviceActionShortcuts, HasAppStrings, HasNetworkConnection, PushesFiles, StartsActivity, FindsByAndroidUIAutomator

Nested Class Summary

Nested classes/interfaces inherited from class org.openqa.selenium.remote.RemoteWebDriver

org.openqa.selenium.remote.RemoteWebDriver.RemoteTargetLocator, org.openqa.selenium.remote.RemoteWebDriver.RemoteWebDriverOptions, org.openqa.selenium.remote.RemoteWebDriver.When

Nested classes/interfaces inherited from interface org.openqa.selenium.WebDriver

org.openqa.selenium.WebDriver.ImeHandler, org.openqa.selenium.WebDriver.Navigation, org.openqa.selenium.WebDriver.Options, org.openqa.selenium.WebDriver.TargetLocator, org.openqa.selenium.WebDriver.Timeouts, org.openqa.selenium.WebDriver.Window

Field Summary

Fields inherited from class io.appium.java_client.AppiumDriver

KEY_CODE, PATH

Constructor Summary

Constructors

Constructor and Description
AndroidDriver(URL remoteAddress, org.openqa.selenium.Capabilities desiredCapabilities)

Method Summary

Methods

Modifier and Type	Method and Description
String	currentActivity() Get the current activity being run on the mobile device
void	endTestCoverage(String intent, String path) Get test-coverage data
org.openqa.selenium.WebElement	findElementByAndroidUIAutomator(String using)
List<org.openqa.selenium.WebElement>	findElementsByAndroidUIAutomator(String using)
String	getAppStrings() Get all defined Strings from an Android app for the default language
String	getAppStrings(String language) Get all defined Strings from an Android app for the specified language
NetworkConnectionSetting	getNetworkConnection() Get the current network settings of the device.
void	ignoreUnimportantViews(Boolean compress) Set the `ignoreUnimportantViews` setting.
boolean	isLocked() Check if the device is locked.
void	openNotifications() Open the notification shade, on Android devices.
void	pushFile(String remotePath, byte[] base64Data) Save base64 encoded data as a file on the remote mobile device.
MobileElement	scrollTo(String text) Scroll forward to the element which has a description or name which contains the input text.
MobileElement	scrollToExact(String text) Scroll forward to the element which has a description or name which exactly matches the input text.
void	sendKeyEvent(int key, Integer metastate) Send a key event along with an Android metastate to an Android device Metastates are things like *shift* to get uppercase characters
void	setNetworkConnection(NetworkConnectionSetting connection) Set the network connection of the device.
void	startActivity(String appPackage, String appActivity) This method should start arbitrary activity during a test.
void	startActivity(String appPackage, String appActivity, String appWaitPackage, String appWaitActivity) This method should start arbitrary activity during a test.

Methods inherited from class io.appium.java_client.AppiumDriver

_isNotNullOrEmpty, _isNotNullOrEmpty, closeApp, context, execute, execute, findElementByAccessibilityId, findElementsByAccessibilityId, getCommandImmutableMap, getCommandImmutableMap, getContext, getContextHandles, getExecuteMethod, getOrientation, getRemoteAddress, getSettings, hideKeyboard, installApp, isAppInstalled, launchApp, location, lockScreen, performMultiTouchAction, performTouchAction, pinch, pinch, pullFile, pullFolder, removeApp, resetApp, rotate, runAppInBackground, sendKeyEvent, setLocation, setSetting, substituteMobilePlatform, swipe, tap, tap, zoom, zoom

Methods inherited from class org.openqa.selenium.remote.RemoteWebDriver

close, executeAsyncScript, executeScript, findElement, findElement, findElementByClassName, findElementByCssSelector, findElementById, findElementByLinkText, findElementByName, findElementByPartialLinkText, findElementByTagName, findElementByXPath, findElements, findElements, findElementsByClassName, findElementsByCssSelector, findElementsById, findElementsByLinkText, findElementsByName, findElementsByPartialLinkText, findElementsByTagName, findElementsByXPath, get, getCapabilities, getCommandExecutor, getCurrentUrl, getElementConverter, getErrorHandler, getFileDetector, getKeyboard, getMouse, getPageSource, getRemoteStatus, getScreenshotAs, getSessionId, getTitle, getWindowHandle, getWindowHandles, log, manage, navigate, quit, setCommandExecutor, setElementConverter, setErrorHandler, setFileDetector, setFoundBy, setLogLevel, setSessionId, startClient, startSession, startSession, stopClient, switchTo, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface io.appium.java_client.DeviceActionShortcuts

hideKeyboard, sendKeyEvent

Methods inherited from interface io.appium.java_client.InteractsWithFiles

pullFile, pullFolder

Methods inherited from interface org.openqa.selenium.WebDriver

close, findElement, findElements, get, getCurrentUrl, getPageSource, getTitle, getWindowHandle, getWindowHandles, manage, navigate, quit, switchTo

Constructor Detail

AndroidDriver

public AndroidDriver(URL remoteAddress,
             org.openqa.selenium.Capabilities desiredCapabilities)

Method Detail

scrollTo

public MobileElement scrollTo(String text)

Scroll forward to the element which has a description or name which contains the input text. The scrolling is performed on the first scrollView present on the UI

Specified by:

scrollTo in interface ScrollsTo

Parameters:

text -

scrollToExact

public MobileElement scrollToExact(String text)

Scroll forward to the element which has a description or name which exactly matches the input text. The scrolling is performed on the first scrollView present on the UI

Specified by:

scrollToExact in interface ScrollsTo

Parameters:

text -

sendKeyEvent

public void sendKeyEvent(int key,
                Integer metastate)

Description copied from interface: AndroidDeviceActionShortcuts

Send a key event along with an Android metastate to an Android device Metastates are things like *shift* to get uppercase characters

Specified by:

sendKeyEvent in interface AndroidDeviceActionShortcuts

Parameters:

key - code for the key pressed on the Android device

metastate - metastate for the keypress

See Also:

AndroidKeyCode, AndroidKeyMetastate, AndroidDeviceActionShortcuts.sendKeyEvent(int, Integer)

getAppStrings

public String getAppStrings()

Description copied from interface: HasAppStrings

Get all defined Strings from an Android app for the default language

Specified by:

getAppStrings in interface HasAppStrings

Returns:

a string of all the localized strings defined in the app

See Also:

HasAppStrings.getAppStrings()

getAppStrings

public String getAppStrings(String language)

Description copied from interface: HasAppStrings

Get all defined Strings from an Android app for the specified language

Specified by:

getAppStrings in interface HasAppStrings

Parameters:

language - strings language code

Returns:

a string of all the localized strings defined in the app

See Also:

HasAppStrings.getAppStrings(String)

getNetworkConnection

public NetworkConnectionSetting getNetworkConnection()

Description copied from interface: HasNetworkConnection

Get the current network settings of the device.

Specified by:

getNetworkConnection in interface HasNetworkConnection

Returns:

NetworkConnectionSetting objects will let you inspect the status of AirplaneMode, Wifi, Data connections

See Also:

HasNetworkConnection.getNetworkConnection()

setNetworkConnection

public void setNetworkConnection(NetworkConnectionSetting connection)

Description copied from interface: HasNetworkConnection

Set the network connection of the device. This is an Android-only method

Specified by:

setNetworkConnection in interface HasNetworkConnection

Parameters:

connection - The NetworkConnectionSetting configuration to use for the device

See Also:

HasNetworkConnection.setNetworkConnection(NetworkConnectionSetting)

pushFile

public void pushFile(String remotePath,
            byte[] base64Data)

Description copied from interface: PushesFiles

Save base64 encoded data as a file on the remote mobile device.

Specified by:

pushFile in interface PushesFiles

Parameters:

remotePath - Path to file to write data to on remote device

base64Data - Base64 encoded byte array of data to write to remote device

See Also:

PushesFiles.pushFile(String, byte[])

startActivity

public void startActivity(String appPackage,
                 String appActivity,
                 String appWaitPackage,
                 String appWaitActivity)
                   throws IllegalArgumentException

Description copied from interface: StartsActivity

This method should start arbitrary activity during a test. If the activity belongs to another application, that application is started and the activity is opened.

Specified by:

startActivity in interface StartsActivity

Parameters:

appPackage - The package containing the activity. [Required]

appActivity - The activity to start. [Required]

appWaitPackage - Automation will begin after this package starts. [Optional]

appWaitActivity - Automation will begin after this activity starts. [Optional]

Throws:

IllegalArgumentException

See Also:

StartsActivity.startActivity(String, String, String, String)

startActivity

public void startActivity(String appPackage,
                 String appActivity)
                   throws IllegalArgumentException

Description copied from interface: StartsActivity

This method should start arbitrary activity during a test. If the activity belongs to another application, that application is started and the activity is opened.

Specified by:

startActivity in interface StartsActivity

Parameters:

appPackage - The package containing the activity. [Required]

appActivity - The activity to start. [Required]

Throws:

IllegalArgumentException

See Also:

StartsActivity.startActivity(String, String)

endTestCoverage

public void endTestCoverage(String intent,
                   String path)

Get test-coverage data

Parameters:

intent - intent to broadcast

path - path to .ec file

currentActivity

public String currentActivity()

Get the current activity being run on the mobile device

openNotifications

public void openNotifications()

Open the notification shade, on Android devices.

isLocked

public boolean isLocked()

Check if the device is locked.

Returns:

true if device is locked. False otherwise

ignoreUnimportantViews

public void ignoreUnimportantViews(Boolean compress)

Set the `ignoreUnimportantViews` setting. *Android-only method* Sets whether Android devices should use `setCompressedLayoutHeirarchy()` which ignores all views which are marked IMPORTANT_FOR_ACCESSIBILITY_NO or IMPORTANT_FOR_ACCESSIBILITY_AUTO (and have been deemed not important by the system), in an attempt to make things less confusing or faster.

Parameters:

compress - ignores unimportant views if true, doesn't ignore otherwise.

findElementByAndroidUIAutomator

public org.openqa.selenium.WebElement findElementByAndroidUIAutomator(String using)

Specified by:

findElementByAndroidUIAutomator in interface FindsByAndroidUIAutomator

findElementsByAndroidUIAutomator

public List<org.openqa.selenium.WebElement> findElementsByAndroidUIAutomator(String using)

Specified by:

findElementsByAndroidUIAutomator in interface FindsByAndroidUIAutomator