com.android.builder.testing

Class ConnectedDevice

java.lang.Object

com.android.builder.testing.api.DeviceConnector

com.android.builder.testing.ConnectedDevice

All Implemented Interfaces:

com.android.ddmlib.IShellEnabledDevice

public class ConnectedDevice
extends com.android.builder.testing.api.DeviceConnector

Local device connected to with ddmlib. This is a wrapper around IDevice.

Constructor Summary

Constructors

Constructor and Description
ConnectedDevice(com.android.ddmlib.IDevice iDevice, com.android.utils.ILogger logger, long timeout, java.util.concurrent.TimeUnit timeUnit)

Method Summary

Modifier and Type	Method and Description
void	connect(int timeout, com.android.utils.ILogger logger)
void	disconnect(int timeout, com.android.utils.ILogger logger)
void	executeShellCommand(java.lang.String command, com.android.ddmlib.IShellOutputReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, java.util.concurrent.TimeUnit maxTimeUnits)
void	executeShellCommand(java.lang.String command, com.android.ddmlib.IShellOutputReceiver receiver, long maxTimeToOutputResponse, java.util.concurrent.TimeUnit maxTimeUnits)
java.util.List<java.lang.String>	getAbis()
java.lang.String	getApiCodeName()
int	getApiLevel()
int	getDensity()
com.android.builder.testing.api.DeviceConfig	getDeviceConfig()
int	getHeight()
com.android.ddmlib.IDevice	getIDevice() Returns the corresponding IDevice.
java.lang.String	getLanguage()
java.util.Set<java.lang.String>	getLanguageSplits()
java.lang.String	getName()
java.lang.String	getNameSuffix()
java.lang.String	getNullableProperty(java.lang.String propertyName)
java.lang.String	getProperty(java.lang.String propertyName)
java.lang.String	getRegion()
java.lang.String	getSerialNumber()
com.android.ddmlib.IDevice.DeviceState	getState()
java.util.concurrent.Future<java.lang.String>	getSystemProperty(java.lang.String name)
int	getWidth()
void	installPackage(java.io.File apkFile, java.util.Collection<java.lang.String> options, int timeout, com.android.utils.ILogger logger)
void	installPackages(java.util.List<java.io.File> splitApkFiles, java.util.Collection<java.lang.String> options, int timeoutInMs, com.android.utils.ILogger logger)
void	pullFile(java.lang.String remote, java.lang.String local)
void	uninstallPackage(java.lang.String packageName, int timeout, com.android.utils.ILogger logger)

Methods inherited from class java.lang.Object

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

Constructor Detail

ConnectedDevice

public ConnectedDevice(@NonNull
                       com.android.ddmlib.IDevice iDevice,
                       @NonNull
                       com.android.utils.ILogger logger,
                       long timeout,
                       @NonNull
                       java.util.concurrent.TimeUnit timeUnit)

Method Detail

getName

@NonNull
public java.lang.String getName()

getNameSuffix

public java.lang.String getNameSuffix()

connect

public void connect(int timeout,
                    com.android.utils.ILogger logger)
             throws com.android.ddmlib.TimeoutException

Specified by:

connect in class com.android.builder.testing.api.DeviceConnector

Throws:

com.android.ddmlib.TimeoutException

disconnect

public void disconnect(int timeout,
                       com.android.utils.ILogger logger)
                throws com.android.ddmlib.TimeoutException

Specified by:

disconnect in class com.android.builder.testing.api.DeviceConnector

Throws:

com.android.ddmlib.TimeoutException

installPackage

public void installPackage(@NonNull
                           java.io.File apkFile,
                           @NonNull
                           java.util.Collection<java.lang.String> options,
                           int timeout,
                           com.android.utils.ILogger logger)
                    throws com.android.builder.testing.api.DeviceException

Specified by:

installPackage in class com.android.builder.testing.api.DeviceConnector

Throws:

com.android.builder.testing.api.DeviceException

installPackages

public void installPackages(@NonNull
                            java.util.List<java.io.File> splitApkFiles,
                            @NonNull
                            java.util.Collection<java.lang.String> options,
                            int timeoutInMs,
                            com.android.utils.ILogger logger)
                     throws com.android.builder.testing.api.DeviceException

Specified by:

installPackages in class com.android.builder.testing.api.DeviceConnector

Throws:

com.android.builder.testing.api.DeviceException

uninstallPackage

public void uninstallPackage(@NonNull
                             java.lang.String packageName,
                             int timeout,
                             com.android.utils.ILogger logger)
                      throws com.android.builder.testing.api.DeviceException

Specified by:

uninstallPackage in class com.android.builder.testing.api.DeviceConnector

Throws:

com.android.builder.testing.api.DeviceException

executeShellCommand

public void executeShellCommand(java.lang.String command,
                                com.android.ddmlib.IShellOutputReceiver receiver,
                                long maxTimeToOutputResponse,
                                java.util.concurrent.TimeUnit maxTimeUnits)
                         throws com.android.ddmlib.TimeoutException,
                                com.android.ddmlib.AdbCommandRejectedException,
                                com.android.ddmlib.ShellCommandUnresponsiveException,
                                java.io.IOException

Throws:

com.android.ddmlib.TimeoutException

com.android.ddmlib.AdbCommandRejectedException

com.android.ddmlib.ShellCommandUnresponsiveException

java.io.IOException

executeShellCommand

public void executeShellCommand(java.lang.String command,
                                com.android.ddmlib.IShellOutputReceiver receiver,
                                long maxTimeout,
                                long maxTimeToOutputResponse,
                                java.util.concurrent.TimeUnit maxTimeUnits)
                         throws com.android.ddmlib.TimeoutException,
                                com.android.ddmlib.AdbCommandRejectedException,
                                com.android.ddmlib.ShellCommandUnresponsiveException,
                                java.io.IOException

Throws:

com.android.ddmlib.TimeoutException

com.android.ddmlib.AdbCommandRejectedException

com.android.ddmlib.ShellCommandUnresponsiveException

java.io.IOException

getSystemProperty

@NonNull
public java.util.concurrent.Future<java.lang.String> getSystemProperty(@NonNull
                                                                                java.lang.String name)

pullFile

public void pullFile(java.lang.String remote,
                     java.lang.String local)
              throws java.io.IOException

Specified by:

pullFile in class com.android.builder.testing.api.DeviceConnector

Throws:

java.io.IOException

getSerialNumber

@NonNull
public java.lang.String getSerialNumber()

Specified by:

getSerialNumber in class com.android.builder.testing.api.DeviceConnector

getApiLevel

public int getApiLevel()

Specified by:

getApiLevel in class com.android.builder.testing.api.DeviceConnector

getApiCodeName

@Nullable
public java.lang.String getApiCodeName()

Specified by:

getApiCodeName in class com.android.builder.testing.api.DeviceConnector

getState

@Nullable
public com.android.ddmlib.IDevice.DeviceState getState()

Specified by:

getState in class com.android.builder.testing.api.DeviceConnector

getAbis

@NonNull
public java.util.List<java.lang.String> getAbis()

Specified by:

getAbis in class com.android.builder.testing.api.DeviceConnector

getDensity

public int getDensity()

Specified by:

getDensity in class com.android.builder.testing.api.DeviceConnector

getHeight

public int getHeight()

Specified by:

getHeight in class com.android.builder.testing.api.DeviceConnector

getWidth

public int getWidth()

Specified by:

getWidth in class com.android.builder.testing.api.DeviceConnector

getLanguage

public java.lang.String getLanguage()

Specified by:

getLanguage in class com.android.builder.testing.api.DeviceConnector

getLanguageSplits

@Nullable
public java.util.Set<java.lang.String> getLanguageSplits()
                                                            throws com.android.ddmlib.TimeoutException,
                                                                   com.android.ddmlib.AdbCommandRejectedException,
                                                                   com.android.ddmlib.ShellCommandUnresponsiveException,
                                                                   java.io.IOException

Specified by:

getLanguageSplits in class com.android.builder.testing.api.DeviceConnector

Throws:

com.android.ddmlib.TimeoutException

com.android.ddmlib.AdbCommandRejectedException

com.android.ddmlib.ShellCommandUnresponsiveException

java.io.IOException

getRegion

public java.lang.String getRegion()

Specified by:

getRegion in class com.android.builder.testing.api.DeviceConnector

getProperty

@NonNull
public java.lang.String getProperty(@NonNull
                                             java.lang.String propertyName)

Specified by:

getProperty in class com.android.builder.testing.api.DeviceConnector

getNullableProperty

@Nullable
public java.lang.String getNullableProperty(@NonNull
                                                      java.lang.String propertyName)

Specified by:

getNullableProperty in class com.android.builder.testing.api.DeviceConnector

getDeviceConfig

@NonNull
public com.android.builder.testing.api.DeviceConfig getDeviceConfig()
                                                                      throws com.android.builder.testing.api.DeviceException

Specified by:

getDeviceConfig in class com.android.builder.testing.api.DeviceConnector

Throws:

com.android.builder.testing.api.DeviceException

getIDevice

@NonNull
public com.android.ddmlib.IDevice getIDevice()

Returns the corresponding IDevice. Used in packages common to Studio and the Plugin.