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.

DeviceUpdateTargetPreparer

public abstract class DeviceUpdateTargetPreparer
extends DeviceBuildInfoBootStrapper

java.lang.Object
↳	com.android.tradefed.targetprep.BaseTargetPreparer
	↳	com.android.tradefed.targetprep.DeviceBuildInfoBootStrapper
		↳	com.android.tradefed.targetprep.DeviceUpdateTargetPreparer

Known direct subclasses

DeviceImageZipFlashingTargetPreparer

DeviceImageZipFlashingTargetPreparer A target preparer that flashes the device with device images provided via a specific format.

An abstract ITargetPreparer that takes care of common steps around updating devices with a device image file from an external source (as opposed to a build service). The actual update mechanism is delegated to implementor of subclasses.

Summary

Public constructors
`DeviceUpdateTargetPreparer()`

Public methods
`void`	`setUp(TestInformation testInfo)`

Protected methods
`abstract File`	`getDeviceUpdateImage()` Provides a `ERROR(/File)` instance representing the device image file to be used for updating
`abstract void`	`performDeviceUpdate(File deviceUpdateImage, ITestDevice device)` Performs the device image update on device
`abstract void`	`postUpdateActions(File deviceUpdateImage, ITestDevice device)` Actions to be performed after the device is updated but before post update setup steps are performed.
`abstract void`	`preUpdateActions(File deviceUpdateImage, ITestDevice device)` Actions to be performed before the device is updated.

Public constructors

DeviceUpdateTargetPreparer

public DeviceUpdateTargetPreparer ()

Public methods

setUp

public void setUp (TestInformation testInfo)

Parameters
`testInfo`	`TestInformation`

Throws
`BuildError`
`DeviceNotAvailableException`
`TargetSetupError`

Protected methods

getDeviceUpdateImage

protected abstract File getDeviceUpdateImage ()

Provides a ERROR(/File) instance representing the device image file to be used for updating

Returns
`File`

performDeviceUpdate

protected abstract void performDeviceUpdate (File deviceUpdateImage, 
                ITestDevice device)

Performs the device image update on device

Throws
`TargetSetupError`
`DeviceNotAvailableException`

postUpdateActions

protected abstract void postUpdateActions (File deviceUpdateImage, 
                ITestDevice device)

Actions to be performed after the device is updated but before post update setup steps are performed. This method will be called outside of flashing concurrency control.

Throws
`TargetSetupError`
`DeviceNotAvailableException`

preUpdateActions

protected abstract void preUpdateActions (File deviceUpdateImage, 
                ITestDevice device)

Actions to be performed before the device is updated. This method will be called outside of flashing concurrency control.

Throws
`TargetSetupError`
`DeviceNotAvailableException`