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 coloca archivos especificados (bootloader, radio, archivo ZIP de la imagen del dispositivo) en IDeviceBuildInfo para que los dispositivos se escriban con FastbootDeviceFlasher y, luego, inserta atributos del dispositivo posterior al inicio en la información de compilación para generar informes de resultados.

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

Resumen

Constructores públicos
`DeviceFlashPreparer()`

Métodos públicos
`void`	`addAllowedBranchForTransitionInIncremental(String branch)`
`void`	`addBranchTransitionInIncremental(String origin, String destination)`
`IBuildInfo`	`getBuild(TestInformation testInfo)` Une getBuildInfo para que tengamos un cambio para 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)` Inyecta 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)` Configura la opción userdata-flash
`void`	`setWipeAfterApplySnapshot(boolean wipeAfterApplySnapshot)`
`void`	`tearDown(TestInformation testInfo, Throwable e)`
`void`	`useMerkleTreeComparison(boolean enableMerkleTreeComparison)`

Métodos protegidos
`void`	`checkDeviceProductType(ITestDevice device, IDeviceBuildInfo deviceBuild)` Posible verificación antes de escribir en la memoria flash para garantizar que el dispositivo funcione según lo 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 tiempo de la actualización del firmware 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`

getBuild

public IBuildInfo getBuild (TestInformation testInfo)

Une getBuildInfo para que tengamos un cambio para 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)

Inyecta 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)

Configura 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

checkDeviceProductType

protected void checkDeviceProductType (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Posible verificación antes de escribir en la memoria flash para garantizar que el dispositivo funcione según lo esperado en comparación con la información de la compilación.

Parámetros
`device`	`ITestDevice`: Es el `ITestDevice` que se debe activar.
`deviceBuild`	`IDeviceBuildInfo`: Es el `IDeviceBuildInfo` que se usa para escribir en la memoria 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 tiempo de la actualización del firmware del dispositivo al backend de métricas

Parámetros
`branch`	`String`: Es la rama de la que se originó la compilación del dispositivo.
`buildFlavor`	`String`: Es el tipo 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 intermitencia.
`flashingTime`	`long`: Es el tiempo que se dedica a escribir la imagen ZIP del dispositivo.
`flashingStatus`	`CommandStatus`: Es el estado de ejecución del comando de actualización.

setSkipPostFlashBuildIdCheck

protected void setSkipPostFlashBuildIdCheck (boolean skipPostFlashBuildIdCheck)

Parámetros
`skipPostFlashBuildIdCheck`	`boolean`

setUseIncrementalFlashing

protected void setUseIncrementalFlashing (boolean incrementalFlashing)

Parámetros
`incrementalFlashing`	`boolean`