io.selendroid.standalone.android.impl

Class AbstractDevice

java.lang.Object

io.selendroid.standalone.android.impl.AbstractDevice

All Implemented Interfaces:

AndroidDevice

Direct Known Subclasses:

DefaultAndroidEmulator, DefaultHardwareDevice

public abstract class AbstractDevice
extends Object
implements AndroidDevice

Field Summary

Fields

Modifier and Type	Field and Description
protected String	apiTargetType
protected com.android.ddmlib.IDevice	device
protected String	model
protected Integer	port
protected String	serial
static String	WD_STATUS_ENDPOINT

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractDevice()
	AbstractDevice(com.android.ddmlib.IDevice device) Constructor mean to be used with Android Hardware devices because a reference to the IDevice will be available immediately after they are connected.
	AbstractDevice(String serial) Constructor meant to be used with Android Emulators because a reference to the IDevice will become available if the emulator will be started.

Method Summary

Methods

Modifier and Type	Method and Description
void	clearUserData(AndroidApp app)
boolean	equals(Object o)
protected String	executeCommandQuietly(org.apache.commons.exec.CommandLine command)
protected String	executeCommandQuietly(org.apache.commons.exec.CommandLine command, long timeout)
protected static String	extractValue(String regex, String output)
void	forwardPort(int local, int remote)
String	getAPITargetType()
String	getCrashLog()
String	getExternalStoragePath()
List<org.openqa.selenium.logging.LogEntry>	getLogs()
String	getModel()
protected String	getProp(String key)
int	getSelendroidsPort()
int	hashCode()
void	inputKeyevent(int value) Use adb to send a keyevent to the device.
void	install(AndroidApp app)
void	invokeActivity(String activity)
boolean	isDeviceReady()
boolean	isInstalled(AndroidApp app)
boolean	isInstalled(String appBasePackage)
boolean	isLoggingEnabled()
boolean	isSelendroidRunning()
protected boolean	isSerialConfigured()
void	kill(AndroidApp aut)
String	listRunningThirdPartyProcesses() Returns the output of running 'adb shell ps', filtering out system processes.
void	restartADB()
String	runAdbCommand(String parameter)
boolean	screenSizeMatches(String requestedScreenSize)
void	setLoggingEnabled(boolean loggingEnabled)
void	setVerbose()
boolean	start(AndroidApp app)
void	startSelendroid(AndroidApp aut, int port, SelendroidCapabilities capabilities)
byte[]	takeScreenshot()
protected byte[]	toByteArray(BufferedImage image)
void	uninstall(AndroidApp app)

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface io.selendroid.standalone.android.AndroidDevice

getLocale, getScreenSize, getSerial, getTargetPlatform, unlockScreen

Field Detail

WD_STATUS_ENDPOINT

public static final String WD_STATUS_ENDPOINT

See Also:

Constant Field Values

serial

protected String serial

model

protected String model

apiTargetType

protected String apiTargetType

port

protected Integer port

device

protected com.android.ddmlib.IDevice device

Constructor Detail

AbstractDevice

public AbstractDevice(String serial)

Constructor meant to be used with Android Emulators because a reference to the IDevice will become available if the emulator will be started. Please make sure that #setIDevice is called on the emulator.

Parameters:

serial -

AbstractDevice

public AbstractDevice(com.android.ddmlib.IDevice device)

Constructor mean to be used with Android Hardware devices because a reference to the IDevice will be available immediately after they are connected.

Parameters:

device -

AbstractDevice

protected AbstractDevice()

Method Detail

isSerialConfigured

protected boolean isSerialConfigured()

setVerbose

public void setVerbose()

Specified by:

setVerbose in interface AndroidDevice

isDeviceReady

public boolean isDeviceReady()

Specified by:

isDeviceReady in interface AndroidDevice

isInstalled

public boolean isInstalled(String appBasePackage)
                    throws AndroidSdkException

Specified by:

isInstalled in interface AndroidDevice

Throws:

AndroidSdkException

isInstalled

public boolean isInstalled(AndroidApp app)
                    throws AndroidSdkException

Specified by:

isInstalled in interface AndroidDevice

Throws:

AndroidSdkException

install

public void install(AndroidApp app)
             throws AndroidSdkException

Specified by:

install in interface AndroidDevice

Throws:

AndroidSdkException

start

public boolean start(AndroidApp app)
              throws AndroidSdkException

Specified by:

start in interface AndroidDevice

Throws:

AndroidSdkException

executeCommandQuietly

protected String executeCommandQuietly(org.apache.commons.exec.CommandLine command)

executeCommandQuietly

protected String executeCommandQuietly(org.apache.commons.exec.CommandLine command,
                           long timeout)

uninstall

public void uninstall(AndroidApp app)
               throws AndroidSdkException

Specified by:

uninstall in interface AndroidDevice

Throws:

AndroidSdkException

clearUserData

public void clearUserData(AndroidApp app)
                   throws AndroidSdkException

Specified by:

clearUserData in interface AndroidDevice

Throws:

AndroidSdkException

kill

public void kill(AndroidApp aut)
          throws AndroidDeviceException,
                 AndroidSdkException

Specified by:

kill in interface AndroidDevice

Throws:

AndroidDeviceException

AndroidSdkException

startSelendroid

public void startSelendroid(AndroidApp aut,
                   int port,
                   SelendroidCapabilities capabilities)
                     throws AndroidSdkException

Specified by:

startSelendroid in interface AndroidDevice

Throws:

AndroidSdkException

forwardPort

public void forwardPort(int local,
               int remote)

Specified by:

forwardPort in interface AndroidDevice

isSelendroidRunning

public boolean isSelendroidRunning()

Specified by:

isSelendroidRunning in interface AndroidDevice

getSelendroidsPort

public int getSelendroidsPort()

Specified by:

getSelendroidsPort in interface AndroidDevice

getLogs

public List<org.openqa.selenium.logging.LogEntry> getLogs()

Specified by:

getLogs in interface AndroidDevice

isLoggingEnabled

public boolean isLoggingEnabled()

Specified by:

isLoggingEnabled in interface AndroidDevice

setLoggingEnabled

public void setLoggingEnabled(boolean loggingEnabled)

Specified by:

setLoggingEnabled in interface AndroidDevice

getProp

protected String getProp(String key)

extractValue

protected static String extractValue(String regex,
                  String output)

screenSizeMatches

public boolean screenSizeMatches(String requestedScreenSize)

Specified by:

screenSizeMatches in interface AndroidDevice

runAdbCommand

public String runAdbCommand(String parameter)

Specified by:

runAdbCommand in interface AndroidDevice

takeScreenshot

public byte[] takeScreenshot()
                      throws AndroidDeviceException

Specified by:

takeScreenshot in interface AndroidDevice

Throws:

AndroidDeviceException

toByteArray

protected byte[] toByteArray(BufferedImage image)
                      throws AndroidDeviceException

Throws:

AndroidDeviceException

inputKeyevent

public void inputKeyevent(int value)

Use adb to send a keyevent to the device. Full list of keys available here: http://developer.android.com/reference/android/view/KeyEvent.html

Specified by:

inputKeyevent in interface AndroidDevice

Parameters:

value - - Key to be sent to 'adb shell input keyevent'

invokeActivity

public void invokeActivity(String activity)

Specified by:

invokeActivity in interface AndroidDevice

restartADB

public void restartADB()

Specified by:

restartADB in interface AndroidDevice

getExternalStoragePath

public String getExternalStoragePath()

Specified by:

getExternalStoragePath in interface AndroidDevice

getCrashLog

public String getCrashLog()

Specified by:

getCrashLog in interface AndroidDevice

Returns:

empty string if there is no crash log on the device, otherwise returns the stack trace caused by the crash of the AUT

listRunningThirdPartyProcesses

public String listRunningThirdPartyProcesses()

Returns the output of running 'adb shell ps', filtering out system processes.

Specified by:

listRunningThirdPartyProcesses in interface AndroidDevice

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

getModel

public String getModel()

Specified by:

getModel in interface AndroidDevice

getAPITargetType

public String getAPITargetType()

Specified by:

getAPITargetType in interface AndroidDevice