Starting March 27, 2025, we recommend using android-latest-release instead of aosp-main to build and contribute to AOSP. For more information, see Changes to AOSP.

DeviceNotAvailableException

public class DeviceNotAvailableException
extends HarnessException

java.lang.Object
↳	com.android.tradefed.error.HarnessException
	↳	com.android.tradefed.device.DeviceNotAvailableException

Known direct subclasses

DeviceDisconnectedException, DeviceUnresponsiveException

DeviceDisconnectedException	Thrown when a device is no longer reachable via it's transport type, e.g. if the device is no longer visible via USB, or TCP/IP connection
DeviceUnresponsiveException	A specialization of `DeviceNotAvailableException` that indicates device is visible to adb, but is unresponsive (i.e., commands timing out, won't boot, etc)

Thrown when a device is no longer available for testing. e.g. the adb connection to the device has been lost, device has stopped responding to commands, etc

Summary

Public constructors
`DeviceNotAvailableException()` This constructor is deprecated. Use `DeviceNotAvailableException(String, String, com.android.tradefed.result.error.ErrorIdentifier)` instead.
`DeviceNotAvailableException(String msg)` This constructor is deprecated. Use `DeviceNotAvailableException(String, String, com.android.tradefed.result.error.ErrorIdentifier)` instead.
`DeviceNotAvailableException(String msg, String serial)` Creates a `DeviceNotAvailableException`.
`DeviceNotAvailableException(String msg, String serial, ErrorIdentifier errorId)` Creates a `DeviceNotAvailableException`.
`DeviceNotAvailableException(String msg, Throwable cause, String serial)` Creates a `DeviceNotAvailableException`.
`DeviceNotAvailableException(String msg, Throwable cause, String serial, ErrorIdentifier errorId)` Creates a `DeviceNotAvailableException`.

Public methods
`String`	`getSerial()` Return Serial of the device associated with exception.

Public constructors

DeviceNotAvailableException

public DeviceNotAvailableException ()

This constructor is deprecated.
Use DeviceNotAvailableException(String, String, com.android.tradefed.result.error.ErrorIdentifier) instead.

Creates a DeviceNotAvailableException.

DeviceNotAvailableException

public DeviceNotAvailableException (String msg)

This constructor is deprecated.
Use DeviceNotAvailableException(String, String, com.android.tradefed.result.error.ErrorIdentifier) instead.

Creates a DeviceNotAvailableException.

Parameters
`msg`	`String`: a descriptive message.

DeviceNotAvailableException

public DeviceNotAvailableException (String msg, 
                String serial)

Creates a DeviceNotAvailableException.

Parameters
`msg`	`String`: a descriptive message.
`serial`	`String`: the serial of the device concerned

DeviceNotAvailableException

public DeviceNotAvailableException (String msg, 
                String serial, 
                ErrorIdentifier errorId)

Creates a DeviceNotAvailableException.

Parameters
`msg`	`String`: a descriptive message.
`serial`	`String`: the serial of the device concerned
`errorId`	`ErrorIdentifier`: the error identifier for this error.

DeviceNotAvailableException

public DeviceNotAvailableException (String msg, 
                Throwable cause, 
                String serial)

Creates a DeviceNotAvailableException.

Parameters
`msg`	`String`: a descriptive message.
`cause`	`Throwable`: the root `Throwable` that caused the device to become unavailable.
`serial`	`String`: the serial of the device concerned by the exception

DeviceNotAvailableException

public DeviceNotAvailableException (String msg, 
                Throwable cause, 
                String serial, 
                ErrorIdentifier errorId)

Creates a DeviceNotAvailableException.

Parameters
`msg`	`String`: a descriptive message.
`cause`	`Throwable`: the root `Throwable` that caused the device to become unavailable.
`serial`	`String`: the serial of the device concerned by the exception
`errorId`	`ErrorIdentifier`: the error identifier for this error.

Public methods

getSerial

public String getSerial ()

Return Serial of the device associated with exception.

Returns
`String`