com.android.ddmlib

Interface IDevice

All Superinterfaces:

IShellEnabledDevice

public interface IDevice
extends IShellEnabledDevice

A Device. It can be a physical device or an emulator.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	IDevice.DeviceState The state of a device.
static class	IDevice.DeviceUnixSocketNamespace Namespace of a Unix Domain Socket created on the device.
static class	IDevice.Feature Device level software features.
static class	IDevice.HardwareFeature Device level hardware features.

Field Summary

Fields

Modifier and Type	Field and Description
static int	CHANGE_BUILD_INFO Device change bit mask: build info change.
static int	CHANGE_CLIENT_LIST Device change bit mask: Client list change.
static int	CHANGE_STATE Device change bit mask: IDevice.DeviceState change.
static java.lang.String	FIRST_EMULATOR_SN Serial number of the first connected emulator.
static java.lang.String	MNT_DATA
static java.lang.String	MNT_EXTERNAL_STORAGE
static java.lang.String	MNT_ROOT
static java.lang.String	PROP_BUILD_API_LEVEL
static java.lang.String	PROP_BUILD_CHARACTERISTICS
static java.lang.String	PROP_BUILD_CODENAME
static java.lang.String	PROP_BUILD_TAGS
static java.lang.String	PROP_BUILD_TYPE
static java.lang.String	PROP_BUILD_VERSION
static java.lang.String	PROP_BUILD_VERSION_NUMBER Deprecated. Use PROP_BUILD_API_LEVEL.
static java.lang.String	PROP_DEBUGGABLE
static java.lang.String	PROP_DEVICE_CPU_ABI
static java.lang.String	PROP_DEVICE_CPU_ABI_LIST
static java.lang.String	PROP_DEVICE_CPU_ABI2
static java.lang.String	PROP_DEVICE_DENSITY
static java.lang.String	PROP_DEVICE_EMULATOR_DENSITY
static java.lang.String	PROP_DEVICE_LANGUAGE
static java.lang.String	PROP_DEVICE_MANUFACTURER
static java.lang.String	PROP_DEVICE_MODEL
static java.lang.String	PROP_DEVICE_REGION

Method Summary

Modifier and Type	Method and Description
boolean	arePropertiesSet() Returns true if properties have been cached
void	createForward(int localPort, int remotePort) Creates a port forwarding between a local and a remote port.
void	createForward(int localPort, java.lang.String remoteSocketName, IDevice.DeviceUnixSocketNamespace namespace) Creates a port forwarding between a local TCP port and a remote Unix Domain Socket.
default void	executeBinderCommand(java.lang.String[] parameters, IShellOutputReceiver receiver, long maxTimeToOutputResponse, java.util.concurrent.TimeUnit maxTimeUnits, java.io.InputStream is) Executes a Binder command on the device, and sends the result to a receiver
void	executeShellCommand(java.lang.String command, IShellOutputReceiver receiver) Executes a shell command on the device, and sends the result to a receiver
void	executeShellCommand(java.lang.String command, IShellOutputReceiver receiver, int maxTimeToOutputResponse) Deprecated. Use IShellEnabledDevice.executeShellCommand(String, IShellOutputReceiver, long, java.util.concurrent.TimeUnit).
default void	executeShellCommand(java.lang.String command, IShellOutputReceiver receiver, long maxTimeToOutputResponse, java.util.concurrent.TimeUnit maxTimeUnits, java.io.InputStream is) A version of executeShell command that can take an input stream to send through stdin.
java.util.List<java.lang.String>	getAbis() Returns the ABIs supported by this device.
java.lang.String	getAvdName() Returns the name of the AVD the emulator is running.
java.util.concurrent.Future<java.lang.Integer>	getBattery() Return the device's battery level, from 0 to 100 percent.
java.util.concurrent.Future<java.lang.Integer>	getBattery(long freshnessTime, java.util.concurrent.TimeUnit timeUnit) Return the device's battery level, from 0 to 100 percent.
java.lang.Integer	getBatteryLevel() Deprecated. use getBattery()
java.lang.Integer	getBatteryLevel(long freshnessMs) Deprecated. use getBattery(long, TimeUnit)
Client	getClient(java.lang.String applicationName) Returns a Client by its application name.
java.lang.String	getClientName(int pid) Returns the name of the client by pid or null if pid is unknown
Client[]	getClients() Returns the array of clients.
int	getDensity() Returns the density bucket of the device screen by reading the value for system property PROP_DEVICE_DENSITY.
FileListingService	getFileListingService() Returns a FileListingService for this device.
java.lang.String	getLanguage() Returns the user's language.
default InstallMetrics	getLastInstallMetrics() Gets the information about the most recent installation on this device.
java.lang.String	getMountPoint(java.lang.String name) Returns a mount point.
java.util.Map<java.lang.String,java.lang.String>	getProperties() Deprecated. use IShellEnabledDevice.getSystemProperty(String) instead
java.lang.String	getProperty(java.lang.String name) Convenience method that attempts to retrieve a property via IShellEnabledDevice.getSystemProperty(String) with a very short wait time, and swallows exceptions.
java.lang.String	getPropertyCacheOrSync(java.lang.String name) Deprecated. use IShellEnabledDevice.getSystemProperty(String) instead
int	getPropertyCount() Deprecated. implementation detail
java.lang.String	getPropertySync(java.lang.String name) Deprecated. use IShellEnabledDevice.getSystemProperty(String)
java.lang.String	getRegion() Returns the user's region.
RawImage	getScreenshot() Takes a screen shot of the device and returns it as a RawImage.
RawImage	getScreenshot(long timeout, java.util.concurrent.TimeUnit unit)
java.lang.String	getSerialNumber() Returns the serial number of the device.
IDevice.DeviceState	getState() Returns the state of the device.
SyncService	getSyncService() Returns a SyncService object to push / pull files to and from the device.
com.android.sdklib.AndroidVersion	getVersion() Returns the API level of the device.
boolean	hasClients() Returns whether the Device has Clients.
void	installPackage(java.lang.String packageFilePath, boolean reinstall, InstallReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, java.util.concurrent.TimeUnit maxTimeUnits, java.lang.String... extraArgs) Installs an Android application on device.
void	installPackage(java.lang.String packageFilePath, boolean reinstall, InstallReceiver receiver, java.lang.String... extraArgs) Installs an Android application on device.
void	installPackage(java.lang.String packageFilePath, boolean reinstall, java.lang.String... extraArgs) Installs an Android application on device.
default void	installPackages(java.util.List<java.io.File> apks, boolean reinstall, java.util.List<java.lang.String> installOptions) Installs an Android application made of several APK files (one main and 0..n split packages) with default timeout
void	installPackages(java.util.List<java.io.File> apks, boolean reinstall, java.util.List<java.lang.String> installOptions, long timeout, java.util.concurrent.TimeUnit timeoutUnit) Installs an Android application made of several APK files (one main and 0..n split packages)
void	installRemotePackage(java.lang.String remoteFilePath, boolean reinstall, InstallReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, java.util.concurrent.TimeUnit maxTimeUnits, java.lang.String... extraArgs) Installs the application package that was pushed to a temporary location on the device.
void	installRemotePackage(java.lang.String remoteFilePath, boolean reinstall, InstallReceiver receiver, java.lang.String... extraArgs) Installs the application package that was pushed to a temporary location on the device.
void	installRemotePackage(java.lang.String remoteFilePath, boolean reinstall, java.lang.String... extraArgs) Installs the application package that was pushed to a temporary location on the device.
default void	installRemotePackages(java.util.List<java.lang.String> remoteApks, boolean reinstall, java.util.List<java.lang.String> installOptions) Installs an Android application made of several APK files sitting locally on the device with default timeout
default void	installRemotePackages(java.util.List<java.lang.String> remoteApks, boolean reinstall, java.util.List<java.lang.String> installOptions, long timeout, java.util.concurrent.TimeUnit timeoutUnit) Installs an Android application made of several APK files sitting locally on the device
boolean	isBootLoader() Returns if the device is in bootloader mode.
boolean	isEmulator() Returns true if the device is an emulator.
boolean	isOffline() Returns if the device is offline.
boolean	isOnline() Returns if the device is ready.
boolean	isRoot() Queries the current root-status of the device.
void	pullFile(java.lang.String remote, java.lang.String local) Pulls a single file.
void	pushFile(java.lang.String local, java.lang.String remote) Push a single file.
void	reboot(java.lang.String into) Reboot the device.
void	removeForward(int localPort, int remotePort) Removes a port forwarding between a local and a remote port.
void	removeForward(int localPort, java.lang.String remoteSocketName, IDevice.DeviceUnixSocketNamespace namespace) Removes an existing port forwarding between a local and a remote port.
void	removeRemotePackage(java.lang.String remoteFilePath) Removes a file from device.
boolean	root() Ask the adb daemon to become root on the device.
void	runEventLogService(LogReceiver receiver) Runs the event log service and outputs the event log to the LogReceiver.
void	runLogService(java.lang.String logname, LogReceiver receiver) Runs the log service for the given log and outputs the log to the LogReceiver.
void	startScreenRecorder(java.lang.String remoteFilePath, ScreenRecorderOptions options, IShellOutputReceiver receiver) Initiates screen recording on the device if the device supports IDevice.Feature.SCREEN_RECORD.
boolean	supportsFeature(IDevice.Feature feature) Returns whether this device supports the given software feature.
boolean	supportsFeature(IDevice.HardwareFeature feature) Returns whether this device supports the given hardware feature.
java.lang.String	syncPackageToDevice(java.lang.String localFilePath) Pushes a file to device
java.lang.String	uninstallPackage(java.lang.String packageName) Uninstalls an package from the device.

Methods inherited from interface com.android.ddmlib.IShellEnabledDevice

executeShellCommand, executeShellCommand, getName, getSystemProperty

Field Detail

PROP_BUILD_VERSION

static final java.lang.String PROP_BUILD_VERSION

See Also:

Constant Field Values

PROP_BUILD_API_LEVEL

static final java.lang.String PROP_BUILD_API_LEVEL

See Also:

Constant Field Values

PROP_BUILD_CODENAME

static final java.lang.String PROP_BUILD_CODENAME

See Also:

Constant Field Values

PROP_BUILD_TAGS

static final java.lang.String PROP_BUILD_TAGS

See Also:

Constant Field Values

PROP_BUILD_TYPE

static final java.lang.String PROP_BUILD_TYPE

See Also:

Constant Field Values

PROP_DEVICE_MODEL

static final java.lang.String PROP_DEVICE_MODEL

See Also:

Constant Field Values

PROP_DEVICE_MANUFACTURER

static final java.lang.String PROP_DEVICE_MANUFACTURER

See Also:

Constant Field Values

PROP_DEVICE_CPU_ABI_LIST

static final java.lang.String PROP_DEVICE_CPU_ABI_LIST

See Also:

Constant Field Values

PROP_DEVICE_CPU_ABI

static final java.lang.String PROP_DEVICE_CPU_ABI

See Also:

Constant Field Values

PROP_DEVICE_CPU_ABI2

static final java.lang.String PROP_DEVICE_CPU_ABI2

See Also:

Constant Field Values

PROP_BUILD_CHARACTERISTICS

static final java.lang.String PROP_BUILD_CHARACTERISTICS

See Also:

Constant Field Values

PROP_DEVICE_DENSITY

static final java.lang.String PROP_DEVICE_DENSITY

See Also:

Constant Field Values

PROP_DEVICE_EMULATOR_DENSITY

static final java.lang.String PROP_DEVICE_EMULATOR_DENSITY

See Also:

Constant Field Values

PROP_DEVICE_LANGUAGE

static final java.lang.String PROP_DEVICE_LANGUAGE

See Also:

Constant Field Values

PROP_DEVICE_REGION

static final java.lang.String PROP_DEVICE_REGION

See Also:

Constant Field Values

PROP_DEBUGGABLE

static final java.lang.String PROP_DEBUGGABLE

See Also:

Constant Field Values

FIRST_EMULATOR_SN

static final java.lang.String FIRST_EMULATOR_SN

Serial number of the first connected emulator.

See Also:

Constant Field Values

CHANGE_STATE

static final int CHANGE_STATE

Device change bit mask: IDevice.DeviceState change.

See Also:

Constant Field Values

CHANGE_CLIENT_LIST

static final int CHANGE_CLIENT_LIST

Device change bit mask: Client list change.

See Also:

Constant Field Values

CHANGE_BUILD_INFO

static final int CHANGE_BUILD_INFO

Device change bit mask: build info change.

See Also:

Constant Field Values

PROP_BUILD_VERSION_NUMBER

@Deprecated
static final java.lang.String PROP_BUILD_VERSION_NUMBER

Deprecated. Use PROP_BUILD_API_LEVEL.

See Also:

Constant Field Values

MNT_EXTERNAL_STORAGE

static final java.lang.String MNT_EXTERNAL_STORAGE

See Also:

Constant Field Values

MNT_ROOT

static final java.lang.String MNT_ROOT

See Also:

Constant Field Values

MNT_DATA

static final java.lang.String MNT_DATA

See Also:

Constant Field Values

Method Detail

getSerialNumber

@NonNull
java.lang.String getSerialNumber()

Returns the serial number of the device.

getAvdName

@Nullable
java.lang.String getAvdName()

Returns the name of the AVD the emulator is running.

This is only valid if isEmulator() returns true.

If the emulator is not running any AVD (for instance it's running from an Android source tree build), this method will return "<build>".

Returns:

the name of the AVD or null if there isn't any.

getState

IDevice.DeviceState getState()

Returns the state of the device.

getProperties

@Deprecated
java.util.Map<java.lang.String,java.lang.String> getProperties()

Deprecated. use IShellEnabledDevice.getSystemProperty(String) instead

Returns the cached device properties. It contains the whole output of 'getprop'

getPropertyCount

@Deprecated
int getPropertyCount()

Deprecated. implementation detail

Returns the number of property for this device.

getProperty

@Nullable
java.lang.String getProperty(@NonNull
                                       java.lang.String name)

Convenience method that attempts to retrieve a property via IShellEnabledDevice.getSystemProperty(String) with a very short wait time, and swallows exceptions.

Note: Prefer using IShellEnabledDevice.getSystemProperty(String) if you want control over the timeout.

Parameters:

name - the name of the value to return.

Returns:

the value or null if the property value was not immediately available

arePropertiesSet

boolean arePropertiesSet()

Returns true if properties have been cached

getPropertySync

@Deprecated
java.lang.String getPropertySync(java.lang.String name)
                                      throws TimeoutException,
                                             AdbCommandRejectedException,
                                             ShellCommandUnresponsiveException,
                                             java.io.IOException

Deprecated. use IShellEnabledDevice.getSystemProperty(String)

A variant of getProperty(String) that will attempt to retrieve the given property from device directly, without using cache. This method should (only) be used for any volatile properties.

Parameters:

name - the name of the value to return.

Returns:

the value or null if the property does not exist

Throws:

TimeoutException - in case of timeout on the connection.

AdbCommandRejectedException - if adb rejects the command

ShellCommandUnresponsiveException - in case the shell command doesn't send output for a given time.

java.io.IOException - in case of I/O error on the connection.

getPropertyCacheOrSync

@Deprecated
java.lang.String getPropertyCacheOrSync(java.lang.String name)
                                             throws TimeoutException,
                                                    AdbCommandRejectedException,
                                                    ShellCommandUnresponsiveException,
                                                    java.io.IOException

Deprecated. use IShellEnabledDevice.getSystemProperty(String) instead

A combination of getProperty(String) and getPropertySync(String) that will attempt to retrieve the property from cache. If not found, will synchronously attempt to query device directly and repopulate the cache if successful.

Parameters:

name - the name of the value to return.

Returns:

the value or null if the property does not exist

Throws:

TimeoutException - in case of timeout on the connection.

AdbCommandRejectedException - if adb rejects the command

ShellCommandUnresponsiveException - in case the shell command doesn't send output for a given time.

java.io.IOException - in case of I/O error on the connection.

supportsFeature

boolean supportsFeature(@NonNull
                        IDevice.Feature feature)

Returns whether this device supports the given software feature.

supportsFeature

boolean supportsFeature(@NonNull
                        IDevice.HardwareFeature feature)

Returns whether this device supports the given hardware feature.

getMountPoint

@Nullable
java.lang.String getMountPoint(@NonNull
                                         java.lang.String name)

Returns a mount point.

Parameters:

name - the name of the mount point to return

See Also:

MNT_EXTERNAL_STORAGE, MNT_ROOT, MNT_DATA

isOnline

boolean isOnline()

Returns if the device is ready.

Returns:

true if getState() returns IDevice.DeviceState.ONLINE.

isEmulator

boolean isEmulator()

Returns true if the device is an emulator.

isOffline

boolean isOffline()

Returns if the device is offline.

Returns:

true if getState() returns IDevice.DeviceState.OFFLINE.

isBootLoader

boolean isBootLoader()

Returns if the device is in bootloader mode.

Returns:

true if getState() returns IDevice.DeviceState.BOOTLOADER.

hasClients

boolean hasClients()

Returns whether the Device has Clients.

getClients

Client[] getClients()

Returns the array of clients.

getClient

Client getClient(java.lang.String applicationName)

Returns a Client by its application name.

Parameters:

applicationName - the name of the application

Returns:

the Client object or null if no match was found.

getSyncService

SyncService getSyncService()
                    throws TimeoutException,
                           AdbCommandRejectedException,
                           java.io.IOException

Returns a SyncService object to push / pull files to and from the device.

Returns:

null if the SyncService couldn't be created. This can happen if adb refuse to open the connection because the IDevice is invalid (or got disconnected).

Throws:

TimeoutException - in case of timeout on the connection.

AdbCommandRejectedException - if adb rejects the command

java.io.IOException - if the connection with adb failed.

getFileListingService

FileListingService getFileListingService()

Returns a FileListingService for this device.

getScreenshot

RawImage getScreenshot()
                throws TimeoutException,
                       AdbCommandRejectedException,
                       java.io.IOException

Takes a screen shot of the device and returns it as a RawImage.

Returns:

the screenshot as a RawImage or null if something went wrong.

Throws:

TimeoutException - in case of timeout on the connection.

AdbCommandRejectedException - if adb rejects the command

java.io.IOException - in case of I/O error on the connection.

getScreenshot

RawImage getScreenshot(long timeout,
                       java.util.concurrent.TimeUnit unit)
                throws TimeoutException,
                       AdbCommandRejectedException,
                       java.io.IOException

Throws:

TimeoutException

AdbCommandRejectedException

java.io.IOException

startScreenRecorder

void startScreenRecorder(@NonNull
                         java.lang.String remoteFilePath,
                         @NonNull
                         ScreenRecorderOptions options,
                         @NonNull
                         IShellOutputReceiver receiver)
                  throws TimeoutException,
                         AdbCommandRejectedException,
                         java.io.IOException,
                         ShellCommandUnresponsiveException

Initiates screen recording on the device if the device supports IDevice.Feature.SCREEN_RECORD.

Throws:

TimeoutException

AdbCommandRejectedException

java.io.IOException

ShellCommandUnresponsiveException

executeShellCommand

@Deprecated
void executeShellCommand(java.lang.String command,
                                     IShellOutputReceiver receiver,
                                     int maxTimeToOutputResponse)
                              throws TimeoutException,
                                     AdbCommandRejectedException,
                                     ShellCommandUnresponsiveException,
                                     java.io.IOException

Deprecated. Use IShellEnabledDevice.executeShellCommand(String, IShellOutputReceiver, long, java.util.concurrent.TimeUnit).

Throws:

TimeoutException

AdbCommandRejectedException

ShellCommandUnresponsiveException

java.io.IOException

executeShellCommand

void executeShellCommand(java.lang.String command,
                         IShellOutputReceiver receiver)
                  throws TimeoutException,
                         AdbCommandRejectedException,
                         ShellCommandUnresponsiveException,
                         java.io.IOException

Executes a shell command on the device, and sends the result to a receiver

This is similar to calling executeShellCommand(command, receiver, DdmPreferences.getTimeOut()).

Parameters:

command - the shell command to execute

receiver - the IShellOutputReceiver that will receives the output of the shell command

Throws:

TimeoutException - in case of timeout on the connection.

AdbCommandRejectedException - if adb rejects the command

ShellCommandUnresponsiveException - in case the shell command doesn't send output for a given time.

java.io.IOException - in case of I/O error on the connection.

See Also:

executeShellCommand(String, IShellOutputReceiver, int), DdmPreferences.getTimeOut()

executeShellCommand

default void executeShellCommand(java.lang.String command,
                                 IShellOutputReceiver receiver,
                                 long maxTimeToOutputResponse,
                                 java.util.concurrent.TimeUnit maxTimeUnits,
                                 @Nullable
                                 java.io.InputStream is)
                          throws TimeoutException,
                                 AdbCommandRejectedException,
                                 ShellCommandUnresponsiveException,
                                 java.io.IOException

A version of executeShell command that can take an input stream to send through stdin.

Throws:

TimeoutException

AdbCommandRejectedException

ShellCommandUnresponsiveException

java.io.IOException

executeBinderCommand

default void executeBinderCommand(java.lang.String[] parameters,
                                  IShellOutputReceiver receiver,
                                  long maxTimeToOutputResponse,
                                  java.util.concurrent.TimeUnit maxTimeUnits,
                                  @Nullable
                                  java.io.InputStream is)
                           throws TimeoutException,
                                  AdbCommandRejectedException,
                                  ShellCommandUnresponsiveException,
                                  java.io.IOException

Executes a Binder command on the device, and sends the result to a receiver

This uses exec:cmd call or faster abb_exec: if both device OS and host ADB server support Android Binder Bridge execute feature.

Parameters:

command - the binder command to execute

receiver - the IShellOutputReceiver that will receives the output of the binder command

is - optional input stream to send through stdin

Throws:

TimeoutException - in case of timeout on the connection.

AdbCommandRejectedException - if adb rejects the command

ShellCommandUnresponsiveException - in case the binder command doesn't send output for a given time.

java.io.IOException - in case of I/O error on the connection.

See Also:

DdmPreferences.getTimeOut()

runEventLogService

void runEventLogService(LogReceiver receiver)
                 throws TimeoutException,
                        AdbCommandRejectedException,
                        java.io.IOException

Runs the event log service and outputs the event log to the LogReceiver.

This call is blocking until LogReceiver.isCancelled() returns true.

Parameters:

receiver - the receiver to receive the event log entries.

Throws:

TimeoutException - in case of timeout on the connection. This can only be thrown if the timeout happens during setup. Once logs start being received, no timeout will occur as it's not possible to detect a difference between no log and timeout.

AdbCommandRejectedException - if adb rejects the command

java.io.IOException - in case of I/O error on the connection.

runLogService

void runLogService(java.lang.String logname,
                   LogReceiver receiver)
            throws TimeoutException,
                   AdbCommandRejectedException,
                   java.io.IOException

Runs the log service for the given log and outputs the log to the LogReceiver.

This call is blocking until LogReceiver.isCancelled() returns true.

Parameters:

logname - the logname of the log to read from.

receiver - the receiver to receive the event log entries.

Throws:

TimeoutException - in case of timeout on the connection. This can only be thrown if the timeout happens during setup. Once logs start being received, no timeout will occur as it's not possible to detect a difference between no log and timeout.

AdbCommandRejectedException - if adb rejects the command

java.io.IOException - in case of I/O error on the connection.

createForward

void createForward(int localPort,
                   int remotePort)
            throws TimeoutException,
                   AdbCommandRejectedException,
                   java.io.IOException

Creates a port forwarding between a local and a remote port.

Parameters:

localPort - the local port to forward

remotePort - the remote port.

Throws:

TimeoutException - in case of timeout on the connection.

AdbCommandRejectedException - if adb rejects the command

java.io.IOException - in case of I/O error on the connection.

createForward

void createForward(int localPort,
                   java.lang.String remoteSocketName,
                   IDevice.DeviceUnixSocketNamespace namespace)
            throws TimeoutException,
                   AdbCommandRejectedException,
                   java.io.IOException

Creates a port forwarding between a local TCP port and a remote Unix Domain Socket.

Parameters:

localPort - the local port to forward

remoteSocketName - name of the unix domain socket created on the device

namespace - namespace in which the unix domain socket was created

Throws:

TimeoutException - in case of timeout on the connection.

AdbCommandRejectedException - if adb rejects the command

java.io.IOException - in case of I/O error on the connection.

removeForward

void removeForward(int localPort,
                   int remotePort)
            throws TimeoutException,
                   AdbCommandRejectedException,
                   java.io.IOException

Removes a port forwarding between a local and a remote port.

Parameters:

localPort - the local port to forward

remotePort - the remote port.

Throws:

TimeoutException - in case of timeout on the connection.

AdbCommandRejectedException - if adb rejects the command

java.io.IOException - in case of I/O error on the connection.

removeForward

void removeForward(int localPort,
                   java.lang.String remoteSocketName,
                   IDevice.DeviceUnixSocketNamespace namespace)
            throws TimeoutException,
                   AdbCommandRejectedException,
                   java.io.IOException

Removes an existing port forwarding between a local and a remote port.

Parameters:

localPort - the local port to forward

remoteSocketName - the remote unix domain socket name.

namespace - namespace in which the unix domain socket was created

Throws:

TimeoutException - in case of timeout on the connection.

AdbCommandRejectedException - if adb rejects the command

java.io.IOException - in case of I/O error on the connection.

getClientName

java.lang.String getClientName(int pid)

Returns the name of the client by pid or null if pid is unknown

Parameters:

pid - the pid of the client.

pushFile

void pushFile(java.lang.String local,
              java.lang.String remote)
       throws java.io.IOException,
              AdbCommandRejectedException,
              TimeoutException,
              SyncException

Push a single file.

Parameters:

local - the local filepath.

remote - The remote filepath.

Throws:

java.io.IOException - in case of I/O error on the connection.

AdbCommandRejectedException - if adb rejects the command

TimeoutException - in case of a timeout reading responses from the device.

SyncException - if file could not be pushed

pullFile

void pullFile(java.lang.String remote,
              java.lang.String local)
       throws java.io.IOException,
              AdbCommandRejectedException,
              TimeoutException,
              SyncException

Pulls a single file.

Parameters:

remote - the full path to the remote file

local - The local destination.

Throws:

java.io.IOException - in case of an IO exception.

AdbCommandRejectedException - if adb rejects the command

TimeoutException - in case of a timeout reading responses from the device.

SyncException - in case of a sync exception.

installPackage

void installPackage(java.lang.String packageFilePath,
                    boolean reinstall,
                    java.lang.String... extraArgs)
             throws InstallException

Installs an Android application on device. This is a helper method that combines the syncPackageToDevice, installRemotePackage, and removePackage steps

Parameters:

packageFilePath - the absolute file system path to file on local host to install

reinstall - set to true if re-install of app should be performed

extraArgs - optional extra arguments to pass. See 'adb shell pm install --help' for available options.

Throws:

InstallException - if the installation fails.

installPackage

void installPackage(java.lang.String packageFilePath,
                    boolean reinstall,
                    InstallReceiver receiver,
                    java.lang.String... extraArgs)
             throws InstallException

Installs an Android application on device. This is a helper method that combines the syncPackageToDevice, installRemotePackage, and removePackage steps

Parameters:

packageFilePath - the absolute file system path to file on local host to install

reinstall - set to true if re-install of app should be performed

receiver - The InstallReceiver to be used to monitor the install and get final status.

extraArgs - optional extra arguments to pass. See 'adb shell pm install --help' for available options.

Throws:

InstallException - if the installation fails.

installPackage

void installPackage(java.lang.String packageFilePath,
                    boolean reinstall,
                    InstallReceiver receiver,
                    long maxTimeout,
                    long maxTimeToOutputResponse,
                    java.util.concurrent.TimeUnit maxTimeUnits,
                    java.lang.String... extraArgs)
             throws InstallException

Installs an Android application on device. This is a helper method that combines the syncPackageToDevice, installRemotePackage, and removePackage steps

Parameters:

packageFilePath - the absolute file system path to file on local host to install

reinstall - set to true if re-install of app should be performed

receiver - The InstallReceiver to be used to monitor the install and get final status.

maxTimeout - the maximum timeout for the command to return. A value of 0 means no max timeout will be applied.

maxTimeToOutputResponse - the maximum amount of time during which the command is allowed to not output any response. A value of 0 means the method will wait forever (until the receiver cancels the execution) for command output and never throw.

maxTimeUnits - Units for non-zero maxTimeout and maxTimeToOutputResponse values.

extraArgs - optional extra arguments to pass. See 'adb shell pm install --help' for available options.

Throws:

InstallException - if the installation fails.

installPackages

void installPackages(@NonNull
                     java.util.List<java.io.File> apks,
                     boolean reinstall,
                     @NonNull
                     java.util.List<java.lang.String> installOptions,
                     long timeout,
                     @NonNull
                     java.util.concurrent.TimeUnit timeoutUnit)
              throws InstallException

Installs an Android application made of several APK files (one main and 0..n split packages)

Parameters:

apks - list of apks to install (1 main APK + 0..n split apks)

reinstall - set to true if re-install of app should be performed

installOptions - optional extra arguments to pass. See 'adb shell pm install --help' for available options.

timeout - installation timeout

timeoutUnit - TimeUnit corresponding to the timeout parameter

Throws:

InstallException - if the installation fails.

installPackages

default void installPackages(@NonNull
                             java.util.List<java.io.File> apks,
                             boolean reinstall,
                             @NonNull
                             java.util.List<java.lang.String> installOptions)
                      throws InstallException

Installs an Android application made of several APK files (one main and 0..n split packages) with default timeout

Parameters:

apks - list of apks to install (1 main APK + 0..n split apks)

reinstall - set to true if re-install of app should be performed

installOptions - optional extra arguments to pass. See 'adb shell pm install --help' for available options.

Throws:

InstallException - if the installation fails.

getLastInstallMetrics

default InstallMetrics getLastInstallMetrics()

Gets the information about the most recent installation on this device.

Returns:

InstallMetrics metrics describing the installation.

installRemotePackages

default void installRemotePackages(@NonNull
                                   java.util.List<java.lang.String> remoteApks,
                                   boolean reinstall,
                                   @NonNull
                                   java.util.List<java.lang.String> installOptions,
                                   long timeout,
                                   @NonNull
                                   java.util.concurrent.TimeUnit timeoutUnit)
                            throws InstallException

Installs an Android application made of several APK files sitting locally on the device

Parameters:

remoteApks - list of apk file paths sitting on the device to install

reinstall - set to true if re-install of app should be performed

installOptions - optional extra arguments to pass. See 'adb shell pm install --help' for available options.

timeout - installation timeout

timeoutUnit - TimeUnit corresponding to the timeout parameter

Throws:

InstallException - if the installation fails.

installRemotePackages

default void installRemotePackages(@NonNull
                                   java.util.List<java.lang.String> remoteApks,
                                   boolean reinstall,
                                   @NonNull
                                   java.util.List<java.lang.String> installOptions)
                            throws InstallException

Installs an Android application made of several APK files sitting locally on the device with default timeout

Parameters:

apks - list of apk file paths on the device to install

reinstall - set to true if re-install of app should be performed

installOptions - optional extra arguments to pass. See 'adb shell pm install --help' for available options.

Throws:

InstallException - if the installation fails.

syncPackageToDevice

java.lang.String syncPackageToDevice(java.lang.String localFilePath)
                              throws TimeoutException,
                                     AdbCommandRejectedException,
                                     java.io.IOException,
                                     SyncException

Pushes a file to device

Parameters:

localFilePath - the absolute path to file on local host

Returns:

String destination path on device for file

Throws:

TimeoutException - in case of timeout on the connection.

AdbCommandRejectedException - if adb rejects the command

java.io.IOException - in case of I/O error on the connection.

SyncException - if an error happens during the push of the package on the device.

installRemotePackage

void installRemotePackage(java.lang.String remoteFilePath,
                          boolean reinstall,
                          java.lang.String... extraArgs)
                   throws InstallException

Installs the application package that was pushed to a temporary location on the device.

Parameters:

remoteFilePath - absolute file path to package file on device

reinstall - set to true if re-install of app should be performed

extraArgs - optional extra arguments to pass. See 'adb shell pm install --help' for available options.

Throws:

InstallException - if the installation fails.

See Also:

installRemotePackage(String, boolean, InstallReceiver, long, long, TimeUnit, String...)

installRemotePackage

void installRemotePackage(java.lang.String remoteFilePath,
                          boolean reinstall,
                          InstallReceiver receiver,
                          java.lang.String... extraArgs)
                   throws InstallException

Installs the application package that was pushed to a temporary location on the device.

Parameters:

remoteFilePath - absolute file path to package file on device

reinstall - set to true if re-install of app should be performed

receiver - The InstallReceiver to be used to monitor the install and get final status.

extraArgs - optional extra arguments to pass. See 'adb shell pm install --help' for available options.

Throws:

InstallException - if the installation fails.

See Also:

installRemotePackage(String, boolean, InstallReceiver, long, long, TimeUnit, String...)

installRemotePackage

void installRemotePackage(java.lang.String remoteFilePath,
                          boolean reinstall,
                          InstallReceiver receiver,
                          long maxTimeout,
                          long maxTimeToOutputResponse,
                          java.util.concurrent.TimeUnit maxTimeUnits,
                          java.lang.String... extraArgs)
                   throws InstallException

Installs the application package that was pushed to a temporary location on the device.

Parameters:

remoteFilePath - absolute file path to package file on device

reinstall - set to true if re-install of app should be performed

receiver - The InstallReceiver to be used to monitor the install and get final status.

maxTimeout - the maximum timeout for the command to return. A value of 0 means no max timeout will be applied.

maxTimeToOutputResponse - the maximum amount of time during which the command is allowed to not output any response. A value of 0 means the method will wait forever (until the receiver cancels the execution) for command output and never throw.

maxTimeUnits - Units for non-zero maxTimeout and maxTimeToOutputResponse values.

extraArgs - optional extra arguments to pass. See 'adb shell pm install --help' for available options.

Throws:

InstallException - if the installation fails.

removeRemotePackage

void removeRemotePackage(java.lang.String remoteFilePath)
                  throws InstallException

Removes a file from device.

Parameters:

remoteFilePath - path on device of file to remove

Throws:

InstallException - if the installation fails.

uninstallPackage

java.lang.String uninstallPackage(java.lang.String packageName)
                           throws InstallException

Uninstalls an package from the device.

Parameters:

packageName - the Android application package name to uninstall

Returns:

a String with an error code, or null if success.

Throws:

InstallException - if the uninstallation fails.

reboot

void reboot(java.lang.String into)
     throws TimeoutException,
            AdbCommandRejectedException,
            java.io.IOException

Reboot the device.

Parameters:

into - the bootloader name to reboot into, or null to just reboot the device.

Throws:

TimeoutException - in case of timeout on the connection.

AdbCommandRejectedException - if adb rejects the command

java.io.IOException

root

boolean root()
      throws TimeoutException,
             AdbCommandRejectedException,
             java.io.IOException,
             ShellCommandUnresponsiveException

Ask the adb daemon to become root on the device. This may silently fail, and can only succeed on developer builds. See "adb root" for more information.

Returns:

true if the adb daemon is running as root, otherwise false.

Throws:

TimeoutException - in case of timeout on the connection.

AdbCommandRejectedException - if adb rejects the command.

ShellCommandUnresponsiveException - if the root status cannot be queried.

java.io.IOException

isRoot

boolean isRoot()
        throws TimeoutException,
               AdbCommandRejectedException,
               java.io.IOException,
               ShellCommandUnresponsiveException

Queries the current root-status of the device. See "adb root" for more information.

Returns:

true if the adb daemon is running as root, otherwise false.

Throws:

TimeoutException - in case of timeout on the connection.

AdbCommandRejectedException - if adb rejects the command.

java.io.IOException

ShellCommandUnresponsiveException

getBatteryLevel

@Deprecated
java.lang.Integer getBatteryLevel()
                                       throws TimeoutException,
                                              AdbCommandRejectedException,
                                              java.io.IOException,
                                              ShellCommandUnresponsiveException

Deprecated. use getBattery()

Return the device's battery level, from 0 to 100 percent.

The battery level may be cached. Only queries the device for its battery level if 5 minutes have expired since the last successful query.

Returns:

the battery level or null if it could not be retrieved

Throws:

TimeoutException

AdbCommandRejectedException

java.io.IOException

ShellCommandUnresponsiveException

getBatteryLevel

@Deprecated
java.lang.Integer getBatteryLevel(long freshnessMs)
                                       throws TimeoutException,
                                              AdbCommandRejectedException,
                                              java.io.IOException,
                                              ShellCommandUnresponsiveException

Deprecated. use getBattery(long, TimeUnit)

Return the device's battery level, from 0 to 100 percent.

The battery level may be cached. Only queries the device for its battery level if freshnessMs ms have expired since the last successful query.

Parameters:

freshnessMs -

Returns:

the battery level or null if it could not be retrieved

Throws:

ShellCommandUnresponsiveException

TimeoutException

AdbCommandRejectedException

java.io.IOException

getBattery

@NonNull
java.util.concurrent.Future<java.lang.Integer> getBattery()

Return the device's battery level, from 0 to 100 percent.

The battery level may be cached. Only queries the device for its battery level if 5 minutes have expired since the last successful query.

Returns:

a Future that can be used to query the battery level. The Future will return a ExecutionException if battery level could not be retrieved.

getBattery

@NonNull
java.util.concurrent.Future<java.lang.Integer> getBattery(long freshnessTime,
                                                                   @NonNull
                                                                   java.util.concurrent.TimeUnit timeUnit)

Return the device's battery level, from 0 to 100 percent.

The battery level may be cached. Only queries the device for its battery level if freshnessTime has expired since the last successful query.

Parameters:

freshnessTime - the desired recency of battery level

timeUnit - the TimeUnit of freshnessTime

Returns:

a Future that can be used to query the battery level. The Future will return a ExecutionException if battery level could not be retrieved.

getAbis

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

Returns the ABIs supported by this device. The ABIs are sorted in preferred order, with the first ABI being the most preferred.

Returns:

the list of ABIs.

getDensity

int getDensity()

Returns the density bucket of the device screen by reading the value for system property PROP_DEVICE_DENSITY.

Returns:

the density, or -1 if it cannot be determined.

getLanguage

@Nullable
java.lang.String getLanguage()

Returns the user's language.

Returns:

the user's language, or null if it's unknown

getRegion

@Nullable
java.lang.String getRegion()

Returns the user's region.

Returns:

the user's region, or null if it's unknown

getVersion

@NonNull
com.android.sdklib.AndroidVersion getVersion()

Returns the API level of the device.

Returns:

the API level if it can be determined, AndroidVersion.DEFAULT otherwise.