DeviceManager

UNKNOWN_DISPLAY_STRING

public static final String UNKNOWN_DISPLAY_STRING

Display string for unknown properties

Constant Value: "unknown"

ANY_DEVICE_OPTIONS

static final IDeviceSelection ANY_DEVICE_OPTIONS

a DeviceSelectionOptions that matches any device. Visible for testing.

mDvcMon

protected DeviceMonitorMultiplexer mDvcMon

mFastbootEnabled

protected boolean mFastbootEnabled

DeviceManager

public DeviceManager ()

The DeviceManager should be retrieved from the GlobalConfiguration

addAvailableDevice

public void addAvailableDevice (IDevice stubDevice)

addDeviceMonitor

public void addDeviceMonitor (IDeviceMonitor mon)

Adds a IDeviceMonitor

addFastbootListener

public void addFastbootListener (IDeviceManager.IFastbootListener listener)

Informs the manager that a listener is interested in fastboot state changes.

Currently a IDeviceManager will only monitor devices in fastboot if there are one or more active listeners.

TODO: this is a bit of a hack - find a better solution

allocateDevice

public ITestDevice allocateDevice (IDeviceSelection options)

Request a device for testing that meets certain criteria.

allocateDevice

public ITestDevice allocateDevice ()

Request a physical device for testing

connectToTcpDevice

public ITestDevice connectToTcpDevice (String ipAndPort)

Connect to a device with adb-over-tcp

This method allocates a new device, which should eventually be freed via disconnectFromTcpDevice(ITestDevice)

The returned ITestDevice will be online, but may not be responsive.

Note that performing action such as a reboot on a tcp connected device, will sever the tcp connection to the device, and result in a DeviceNotAvailableException

disconnectFromTcpDevice

public boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

Disconnect from an adb-over-tcp connected device.

Switches the device back to usb mode, and frees it.

displayDevicesInfo

public void displayDevicesInfo (PrintWriter stream)

Output a user-friendly description containing list of known devices, their state, and values for commonly used IDeviceSelection options.

executeGlobalAdbCommand

public String executeGlobalAdbCommand (String... cmdArgs)

Execute a adb command not targeted to a particular device eg. 'adb connect'

forceAllocateDevice

public ITestDevice forceAllocateDevice (String serial)

Rudely allocate a device, even if its not currently available.

Will have no effect if device is already allocated.

freeDevice

public void freeDevice (ITestDevice device, 
                FreeDeviceState deviceState)

Return a device to the pool

Attempts to return a device that hasn't been previously allocated will be ignored.

getAdbVersion

public String getAdbVersion ()

Get the adb version currently in use by the device manager.

getAvailableFlashingPermits

public int getAvailableFlashingPermits ()

Get the number of available flashing permits

getFastbootPath

public String getFastbootPath ()

Returns the path to the fastboot binary path to use.

init

public void init (IDeviceSelection globalDeviceFilter, 
                List<IDeviceMonitor> globalDeviceMonitors, 
                IManagedTestDeviceFactory deviceFactory)

Initialize the device manager. This must be called once and only once before any other methods are called.

init

public void init (IDeviceSelection globalDeviceFilter, 
                List<IDeviceMonitor> globalDeviceMonitors)

Initialize the device manager. This must be called once and only once before any other methods are called.

init

public void init ()

Initialize the device manager. This must be called once and only once before any other methods are called.

isEmulator

public boolean isEmulator (String serial)

Determine if given serial represents a emulator

isNullDevice

public boolean isNullDevice (String serial)

Determine if given serial represents a null device

killEmulator

public void killEmulator (ITestDevice device)

Shut down the given emulator.

Blocks until emulator disappears from adb. Will have no effect if emulator is already not available.

launchEmulator

public void launchEmulator (ITestDevice device, 
                long bootTimeout, 
                IRunUtil runUtil, 
                List<String> emulatorArgs)

Helper method to launch emulator.

Will launch the emulator as specified by the caller

listAllDevices

public List<DeviceDescriptor> listAllDevices ()

Returns a map of all known devices and their state

reconnectDeviceToTcp

public ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

A helper method that switches the given usb device to adb-over-tcp mode, and then connects to it via connectToTcpDevice(String).

removeDeviceMonitor

public void removeDeviceMonitor (IDeviceMonitor mon)

Removes a previously added IDeviceMonitor. Has no effect if mon has not been added.

removeFastbootListener

public void removeFastbootListener (IDeviceManager.IFastbootListener listener)

Informs the manager that a listener is no longer interested in fastboot state changes.

restartAdbBridge

public void restartAdbBridge ()

Restart (if stopAdbBridge() was called) adb bridge and services depend on adb connections.

returnFlashingPermit

public void returnFlashingPermit ()

Restore a flashing permit that we acquired previously

stopAdbBridge

public void stopAdbBridge ()

Stop adb bridge and services depend on adb connections.

takeFlashingPermit

public void takeFlashingPermit ()

Request permission to flash. If the number of concurrent flashers is limited, this will wait in line in order to remain under the flash limit count.

terminate

public void terminate ()

Stops device monitoring services, and terminates the ddm library.

This must be called upon application termination.

terminateDeviceMonitor

public void terminateDeviceMonitor ()

Stop the Device Monitors.

terminateDeviceRecovery

public void terminateDeviceRecovery ()

Stops the device recovery thread.

terminateHard

public void terminateHard ()

Like terminate(), but attempts to forcefully shut down adb as well.

waitForFirstDeviceAdded

public boolean waitForFirstDeviceAdded (long timeout)

Wait until a first physical device is connected. If a device was connected before, it returns directly True. If no device was added, it returns false after timeout.