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.

RemoteAndroidVirtualDevice

public class RemoteAndroidVirtualDevice
extends RemoteAndroidDevice

java.lang.Object
↳	com.android.tradefed.device.NativeDevice
	↳	com.android.tradefed.device.TestDevice
		↳	com.android.tradefed.device.RemoteAndroidDevice
			↳	com.android.tradefed.device.cloud.RemoteAndroidVirtualDevice

Extends RemoteAndroidDevice behavior for a full stack android device running in the Google Compute Engine (Gce). Assume the device serial will be in the format : in adb.

Summary

Public constructors
`RemoteAndroidVirtualDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)` Creates a `RemoteAndroidVirtualDevice`.

Public methods
`DeviceInspectionResult`	`debugDeviceNotAvailable()` Inspect a device and return detailed info when a device becomes unavailable.
`GceAvdInfo`	`getAvdInfo()` This method is deprecated. should use the connection API directly
`DeviceDescriptor`	`getDeviceDescriptor(boolean shortDescriptor)` Return a `DeviceDescriptor` from the device information to get info on it without passing the actual device object.
	`getTombstones()` Cuttlefish has a special feature that brings the tombstones to the remote host where we can get them directly.
`CommandResult`	`powerwash()` Attempt to powerwash a GCE instance
`CommandResult`	`powerwashGce(String user, Integer offset)` This method is deprecated. Removed in favor of the connection one
`boolean`	`powerwashGce()`

Public constructors

RemoteAndroidVirtualDevice

public RemoteAndroidVirtualDevice (IDevice device, 
                IDeviceStateMonitor stateMonitor, 
                IDeviceMonitor allocationMonitor)

Creates a RemoteAndroidVirtualDevice.

Parameters
`device`	`IDevice`: the associated `IDevice`
`stateMonitor`	`IDeviceStateMonitor`: the `IDeviceStateMonitor` mechanism to use
`allocationMonitor`	`IDeviceMonitor`: the `IDeviceMonitor` to inform of allocation state changes.

Public methods

debugDeviceNotAvailable

public DeviceInspectionResult debugDeviceNotAvailable ()

Inspect a device and return detailed info when a device becomes unavailable.

Returns
`DeviceInspectionResult`

getAvdInfo

public GceAvdInfo getAvdInfo ()

This method is deprecated.
should use the connection API directly

Returns the GceAvdInfo from the created remote VM. Returns null if the bring up was not successful.

Returns
`GceAvdInfo`

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

Return a DeviceDescriptor from the device information to get info on it without passing the actual device object.

Parameters
`shortDescriptor`	`boolean`: Whether or not to limit descriptor to bare minimum info

Returns
`DeviceDescriptor`

getTombstones

public  getTombstones ()

Cuttlefish has a special feature that brings the tombstones to the remote host where we can get them directly.

Returns
	A list of tombstone files, empty if no tombstone.

Throws
`DeviceNotAvailableException`

powerwash

public CommandResult powerwash ()

Attempt to powerwash a GCE instance

Returns
`CommandResult`	returns CommandResult of the powerwash attempts

Throws
	com.android.tradefed.targetprep.TargetSetupError
`TargetSetupError`

powerwashGce

public CommandResult powerwashGce (String user, 
                Integer offset)

This method is deprecated.
Removed in favor of the connection one

Parameters
`user`	`String`
`offset`	`Integer`

Returns
`CommandResult`

Throws
`TargetSetupError`

powerwashGce

public boolean powerwashGce ()

Returns
`boolean`

Throws
`TargetSetupError`