A partir del 27 de marzo de 2025, te recomendamos que uses android-latest-release en lugar de aosp-main para compilar y contribuir a AOSP. Para obtener más información, consulta Cambios en AOSP.

Se usó la API de Cloud Translation para traducir esta página.

DeviceFlashPreparer

public abstract class DeviceFlashPreparer
extends BaseTargetPreparer implements IConfigurationReceiver, ITestLoggerReceiver

java.lang.Object
↳	com.android.tradefed.targetprep.BaseTargetPreparer
	↳	com.android.tradefed.targetprep.DeviceFlashPreparer

Subclases directas conocidas

FastbootUpdateBootstrapPreparer

FastbootUpdateBootstrapPreparer Un ITargetPreparer que organiza los archivos especificados (cargador de arranque, radio, zip de imagen del dispositivo) en IDeviceBuildInfo para que los dispositivos se escriban con FastbootDeviceFlasher y, luego, inserta atributos del dispositivo posteriores al arranque en la información de compilación para fines de generación de informes de resultados.

Un ITargetPreparer que muestra una imagen en hardware físico de Android.

Resumen

Constructores públicos
`DeviceFlashPreparer()`

Métodos públicos
`void`	`addAllowedBranchForTransitionInIncremental(String branch)`
`void`	`addBranchTransitionInIncremental(String origin, String destination)`
`void`	`addFlasherExtraMetadata( metadata)`
`IBuildInfo`	`getBuild(TestInformation testInfo)` Encapsula getBuildInfo para que podamos anularlo en situaciones específicas.
`ITestLogger`	`getTestLogger()`
`boolean`	`isIncrementalFlashingEnabled()`
`boolean`	`isIncrementalFlashingForceDisabled()`
`void`	`setAllowCrossReleaseFlashing(boolean allowCrossReleaseFlashing)`
`void`	`setAllowUnzipBaseline(boolean allowUnzipBaseline)`
`void`	`setApplySnapshot(boolean applySnapshot)`
`void`	`setConfiguration(IConfiguration configuration)` Inserta el `IConfiguration` en uso.
`void`	`setIgnoreHostOptions(boolean ignoreHostOptions)`
`void`	`setTestLogger(ITestLogger testLogger)` Inyecta la instancia de `ITestLogger`.
`void`	`setUp(TestInformation testInfo)`
`void`	`setUpdateBootloaderFromUserspace(boolean updateBootloaderFromUserspace)`
`void`	`setUseIncrementalNewFlow(boolean useIncrementalNewFlow)`
`void`	`setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption)` Cómo configurar la opción userdata-flash
`void`	`setWipeAfterApplySnapshot(boolean wipeAfterApplySnapshot)`
`void`	`tearDown(TestInformation testInfo, Throwable e)`
`void`	`useMerkleTreeComparison(boolean enableMerkleTreeComparison)`

Métodos protegidos
`boolean`	`checkAntiRollback(IDeviceFlasher flasher, ITestDevice device, IDeviceBuildInfo deviceBuild)`
`void`	`checkDeviceProductType(ITestDevice device, IDeviceBuildInfo deviceBuild)` Es una posible verificación antes de escribir en la memoria flash para garantizar que el dispositivo sea el esperado en comparación con la información de la compilación.
`abstract IDeviceFlasher`	`createFlasher(ITestDevice device)` Crea `IDeviceFlasher` para usar.
`long`	`getDeviceBootWaitTime()` Obtiene el tiempo de espera de inicio del dispositivo
`IHostOptions`	`getHostOptions()` Obtiene la instancia de `IHostOptions` que se usará.
`void`	`reportFlashMetrics(String branch, String buildFlavor, String buildId, String serial, long queueTime, long flashingTime, CommandStatus flashingStatus)` Informa los datos de sincronización del dispositivo al backend de métricas
`void`	`setSkipPostFlashBuildIdCheck(boolean skipPostFlashBuildIdCheck)`
`void`	`setUseIncrementalFlashing(boolean incrementalFlashing)`

Constructores públicos

DeviceFlashPreparer

public DeviceFlashPreparer ()

Métodos públicos

addAllowedBranchForTransitionInIncremental

public void addAllowedBranchForTransitionInIncremental (String branch)

Parámetros
`branch`	`String`

addBranchTransitionInIncremental

public void addBranchTransitionInIncremental (String origin, 
                String destination)

Parámetros
`origin`	`String`
`destination`	`String`

addFlasherExtraMetadata

public void addFlasherExtraMetadata ( metadata)

Parámetros
`metadata`

getBuild

public IBuildInfo getBuild (TestInformation testInfo)

Encapsula getBuildInfo para que podamos anularlo en situaciones específicas.

Parámetros
`testInfo`	`TestInformation`

Muestra
`IBuildInfo`

getTestLogger

public ITestLogger getTestLogger ()

Muestra
`ITestLogger`

isIncrementalFlashingEnabled

public boolean isIncrementalFlashingEnabled ()

Muestra
`boolean`

isIncrementalFlashingForceDisabled

public boolean isIncrementalFlashingForceDisabled ()

Muestra
`boolean`

setAllowCrossReleaseFlashing

public void setAllowCrossReleaseFlashing (boolean allowCrossReleaseFlashing)

Parámetros
`allowCrossReleaseFlashing`	`boolean`

setAllowUnzipBaseline

public void setAllowUnzipBaseline (boolean allowUnzipBaseline)

Parámetros
`allowUnzipBaseline`	`boolean`

setApplySnapshot

public void setApplySnapshot (boolean applySnapshot)

Parámetros
`applySnapshot`	`boolean`

setConfiguration

public void setConfiguration (IConfiguration configuration)

Inserta el IConfiguration en uso.

Parámetros
`configuration`	`IConfiguration`

setIgnoreHostOptions

public void setIgnoreHostOptions (boolean ignoreHostOptions)

Parámetros
`ignoreHostOptions`	`boolean`

setTestLogger

public void setTestLogger (ITestLogger testLogger)

Inyecta la instancia de ITestLogger

Parámetros
`testLogger`	`ITestLogger`

setUp

public void setUp (TestInformation testInfo)

Parámetros
`testInfo`	`TestInformation`

Arroja
`BuildError`
`DeviceNotAvailableException`
`TargetSetupError`

setUpdateBootloaderFromUserspace

public void setUpdateBootloaderFromUserspace (boolean updateBootloaderFromUserspace)

Parámetros
`updateBootloaderFromUserspace`	`boolean`

setUseIncrementalNewFlow

public void setUseIncrementalNewFlow (boolean useIncrementalNewFlow)

Parámetros
`useIncrementalNewFlow`	`boolean`

setUserDataFlashOption

public void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

Cómo configurar la opción userdata-flash

setWipeAfterApplySnapshot

public void setWipeAfterApplySnapshot (boolean wipeAfterApplySnapshot)

Parámetros
`wipeAfterApplySnapshot`	`boolean`

tearDown

public void tearDown (TestInformation testInfo, 
                Throwable e)

Parámetros
`testInfo`	`TestInformation`
`e`	`Throwable`

Arroja
`DeviceNotAvailableException`

useMerkleTreeComparison

public void useMerkleTreeComparison (boolean enableMerkleTreeComparison)

Parámetros
`enableMerkleTreeComparison`	`boolean`

Métodos protegidos

checkAntiRollback

protected boolean checkAntiRollback (IDeviceFlasher flasher, 
                ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Parámetros
`flasher`	`IDeviceFlasher`
`device`	`ITestDevice`
`deviceBuild`	`IDeviceBuildInfo`

Muestra
`boolean`

Arroja
`DeviceNotAvailableException`

checkDeviceProductType

protected void checkDeviceProductType (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Es una posible verificación antes de escribir en la memoria flash para garantizar que el dispositivo sea el esperado en comparación con la información de la compilación.

Parámetros
`device`	`ITestDevice`: Es el `ITestDevice` que se mostrará con flash.
`deviceBuild`	`IDeviceBuildInfo`: Es el `IDeviceBuildInfo` que se usa para el flash.

Arroja
	com.android.tradefed.targetprep.BuildError
	com.android.tradefed.device.DeviceNotAvailableException
`BuildError`
`DeviceNotAvailableException`

createFlasher

protected abstract IDeviceFlasher createFlasher (ITestDevice device)

Crea IDeviceFlasher para usar. Las subclases pueden anular

Parámetros
`device`	`ITestDevice`

Muestra
`IDeviceFlasher`

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getDeviceBootWaitTime

protected long getDeviceBootWaitTime ()

Obtiene el tiempo de espera de inicio del dispositivo

Muestra
`long`

getHostOptions

protected IHostOptions getHostOptions ()

Obtiene la instancia de IHostOptions que se usará.

Se expone para pruebas de unidades

Muestra
`IHostOptions`

reportFlashMetrics

protected void reportFlashMetrics (String branch, 
                String buildFlavor, 
                String buildId, 
                String serial, 
                long queueTime, 
                long flashingTime, 
                CommandStatus flashingStatus)

Informa los datos de sincronización del dispositivo al backend de métricas

Parámetros
`branch`	`String`: Rama desde la que se originó la compilación del dispositivo
`buildFlavor`	`String`: Es la variante de compilación del dispositivo.
`buildId`	`String`: Es el número de compilación de la compilación del dispositivo.
`serial`	`String`: Es el número de serie del dispositivo.
`queueTime`	`long`: Es el tiempo que se espera a que esté disponible un límite de parpadeo.
`flashingTime`	`long`: El tiempo que se tarda en escribir la imagen del dispositivo en el archivo ZIP
`flashingStatus`	`CommandStatus`: Es el estado de ejecución del comando de escritura en la memoria flash.

setSkipPostFlashBuildIdCheck

protected void setSkipPostFlashBuildIdCheck (boolean skipPostFlashBuildIdCheck)

Parámetros
`skipPostFlashBuildIdCheck`	`boolean`

setUseIncrementalFlashing

protected void setUseIncrementalFlashing (boolean incrementalFlashing)

Parámetros
`incrementalFlashing`	`boolean`