A partir de 27 de março de 2025, recomendamos usar android-latest-release em vez de aosp-main para criar e contribuir com o AOSP. Para mais informações, consulte Mudanças no AOSP.

Esta página foi traduzida pela API Cloud Translation.

DeviceFlashPreparer

public abstract class DeviceFlashPreparer
extends BaseTargetPreparer implements IConfigurationReceiver, ITestLoggerReceiver

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

Subclasses diretas conhecidas

FastbootUpdateBootstrapPreparer

FastbootUpdateBootstrapPreparer Um ITargetPreparer que coloca arquivos especificados (bootloader, rádio, ZIP de imagem do dispositivo) em IDeviceBuildInfo para que os dispositivos sejam atualizados com FastbootDeviceFlasher e injete atributos de dispositivo pós-inicialização nas informações de build para fins de geração de relatórios.

Um ITargetPreparer que mostra uma imagem em hardware físico do Android.

Resumo

Construtores públicos
`DeviceFlashPreparer()`

Métodos públicos
`void`	`addAllowedBranchForTransitionInIncremental(String branch)`
`void`	`addBranchTransitionInIncremental(String origin, String destination)`
`IBuildInfo`	`getBuild(TestInformation testInfo)` Encapsular o getBuildInfo para que possamos substituir o método em cenários específicos.
`ITestLogger`	`getTestLogger()`
`boolean`	`isIncrementalFlashingEnabled()`
`boolean`	`isIncrementalFlashingForceDisabled()`
`void`	`setAllowCrossReleaseFlashing(boolean allowCrossReleaseFlashing)`
`void`	`setAllowUnzipBaseline(boolean allowUnzipBaseline)`
`void`	`setApplySnapshot(boolean applySnapshot)`
`void`	`setConfiguration(IConfiguration configuration)` Injeta o `IConfiguration` em uso.
`void`	`setIgnoreHostOptions(boolean ignoreHostOptions)`
`void`	`setTestLogger(ITestLogger testLogger)` Injeta a instância `ITestLogger`.
`void`	`setUp(TestInformation testInfo)`
`void`	`setUpdateBootloaderFromUserspace(boolean updateBootloaderFromUserspace)`
`void`	`setUseIncrementalNewFlow(boolean useIncrementalNewFlow)`
`void`	`setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption)` Definir a opção 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)` Verificação possível antes da atualização para garantir que o dispositivo esteja conforme o esperado em comparação com as informações do build.
`abstract IDeviceFlasher`	`createFlasher(ITestDevice device)` Crie `IDeviceFlasher` para usar.
`long`	`getDeviceBootWaitTime()` Recebe o tempo de espera para inicialização do dispositivo
`IHostOptions`	`getHostOptions()` Recebe a instância `IHostOptions` a ser usada.
`void`	`reportFlashMetrics(String branch, String buildFlavor, String buildId, String serial, long queueTime, long flashingTime, CommandStatus flashingStatus)` Informa dados de tempo de flash do dispositivo ao back-end de métricas
`void`	`setSkipPostFlashBuildIdCheck(boolean skipPostFlashBuildIdCheck)`
`void`	`setUseIncrementalFlashing(boolean incrementalFlashing)`

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

Encapsular o getBuildInfo para que possamos substituir o método em cenários específicos.

Parâmetros
`testInfo`	`TestInformation`

Retorna
`IBuildInfo`

getTestLogger

public ITestLogger getTestLogger ()

Retorna
`ITestLogger`

isIncrementalFlashingEnabled

public boolean isIncrementalFlashingEnabled ()

Retorna
`boolean`

isIncrementalFlashingForceDisabled

public boolean isIncrementalFlashingForceDisabled ()

Retorna
`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)

Injeta o IConfiguration em uso.

Parâmetros
`configuration`	`IConfiguration`

setIgnoreHostOptions

public void setIgnoreHostOptions (boolean ignoreHostOptions)

Parâmetros
`ignoreHostOptions`	`boolean`

setTestLogger

public void setTestLogger (ITestLogger testLogger)

Injeta a instância ITestLogger.

Parâmetros
`testLogger`	`ITestLogger`

setUp

public void setUp (TestInformation testInfo)

Parâmetros
`testInfo`	`TestInformation`

Gera
`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)

Definir a opção 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`

Gera
`DeviceNotAvailableException`

useMerkleTreeComparison

public void useMerkleTreeComparison (boolean enableMerkleTreeComparison)

Parâmetros
`enableMerkleTreeComparison`	`boolean`

Métodos protegidos

checkDeviceProductType

protected void checkDeviceProductType (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Verificação possível antes da atualização para garantir que o dispositivo esteja conforme o esperado em comparação com as informações do build.

Parâmetros
`device`	`ITestDevice`: o `ITestDevice` para piscar.
`deviceBuild`	`IDeviceBuildInfo`: o `IDeviceBuildInfo` usado para atualizar.

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

createFlasher

protected abstract IDeviceFlasher createFlasher (ITestDevice device)

Crie IDeviceFlasher para usar. As subclasses podem substituir

Parâmetros
`device`	`ITestDevice`

Retorna
`IDeviceFlasher`

Gera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getDeviceBootWaitTime

protected long getDeviceBootWaitTime ()

Recebe o tempo de espera para inicialização do dispositivo

Retorna
`long`

getHostOptions

protected IHostOptions getHostOptions ()

Recebe a instância IHostOptions a ser usada.

Exposto para testes de unidade

Retorna
`IHostOptions`

reportFlashMetrics

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

Informa dados de tempo de flash do dispositivo ao back-end de métricas

Parâmetros
`branch`	`String`: a ramificação de origem do build do dispositivo
`buildFlavor`	`String`: o tipo de build do dispositivo
`buildId`	`String`: o número do build do dispositivo
`serial`	`String`: o número de série do dispositivo
`queueTime`	`long`: o tempo gasto esperando que um limite intermitente fique disponível
`flashingTime`	`long`: o tempo gasto no flash do ZIP da imagem do dispositivo
`flashingStatus`	`CommandStatus`: o status de execução do comando de flash

setSkipPostFlashBuildIdCheck

protected void setSkipPostFlashBuildIdCheck (boolean skipPostFlashBuildIdCheck)

Parâmetros
`skipPostFlashBuildIdCheck`	`boolean`

setUseIncrementalFlashing

protected void setUseIncrementalFlashing (boolean incrementalFlashing)

Parâmetros
`incrementalFlashing`	`boolean`