A partir de 2026, para alinhar com nosso modelo de desenvolvimento estável de tronco e garantir a estabilidade da plataforma para o ecossistema, vamos publicar o código-fonte no AOSP no segundo e quarto trimestres. Para criar e contribuir com o AOSP, recomendamos usar android-latest-release em vez de aosp-main. O branch de manifesto android-latest-release sempre vai fazer referência à versão mais recente enviada ao AOSP. Para mais informações, consulte Mudanças no AOSP.

FastbootDeviceFlasher

public class FastbootDeviceFlasher
extends Object implements IDeviceFlasher

java.lang.Object
↳	com.android.tradefed.targetprep.FastbootDeviceFlasher

Subclasses diretas conhecidas

CdmaDeviceFlasher

CdmaDeviceFlasher Uma classe que mostra uma imagem em um dispositivo Android físico com um rádio CDMA.

Uma classe que depende do fastboot para instalar uma imagem em hardware Android físico.

Resumo

Constantes
`String`	`BASEBAND_IMAGE_NAME`

Construtores públicos
`FastbootDeviceFlasher()`

Métodos públicos
`static String`	`fetchImageVersion(IRunUtil runUtil, ITestDevice device, String imageName)` Método auxiliar para receber a versão atual da imagem no dispositivo.
`void`	`flash(ITestDevice device, IDeviceBuildInfo deviceBuild)` Atualiza o build no dispositivo.
`CommandStatus`	`getSystemFlashingStatus()` Recupera o status de execução do comando para atualizar as partições do sistema principal.
`IDeviceFlasher.UserDataFlashOption`	`getUserDataFlashOption()` Recebe se a imagem de dados do usuário deve ser mostrada, apagada ou retida.
`void`	`overrideDeviceOptions(ITestDevice device)` Substitui as opções de um dispositivo.
`void`	`preFlashOperations(ITestDevice device, IDeviceBuildInfo deviceBuild)` Todas as operações e verificações de configuração que precisam ocorrer antes do flash da seção crítica.
`void`	`setDataWipeSkipList( dataWipeSkipList)` Define a lista de caminhos em `/data` para evitar a limpeza ao usar `ITestsZipInstaller` A granularidade da lista de bloqueio é de filhos diretos de `/data`.
`void`	`setFlashOptions( flashOptions)` Define uma lista de opções para transmitir com comandos de flash/atualização.
`void`	`setFlashingResourcesRetriever(IFlashingResourcesRetriever retriever)` Define o mecanismo pelo qual o flasher pode recuperar arquivos de recursos para atualização.
`void`	`setForceSystemFlash(boolean forceSystemFlash)` Define se o sistema sempre deve ser atualizado, mesmo que esteja executando o build atual.
`void`	`setIncrementalFlashing(IncrementalImageUtil incrementalUtil)`
`void`	`setRamdiskPartition(String ramdiskPartition)` Define a partição ramdisk
`void`	`setShouldFlashRamdisk(boolean shouldFlashRamdisk)` Define se um ramdisk adicional precisa ser atualizado após a atualização do dispositivo usando o zip de imagem.
`void`	`setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption)` Alterna se a imagem dos dados do usuário deve ser mostrada, apagada ou retida
`void`	`setWipeTimeout(long timeout)` Defina o tempo limite para limpar os dados.
`boolean`	`shouldFlashRamdisk()` Verifica se o flasher está definido para ter um ramdisk adicional que deve ser atualizado após a atualização do dispositivo via zip de imagem
`boolean`	`shouldSkipBootloaderVersionCheck()`
`static boolean`	`stderrContainsFailed(String stderr, boolean skipBootloaderVersionCheck)`
`static boolean`	`stderrContainsFailed(String stderr, boolean skipBootloaderVersionCheck, boolean skipFastbootFailedMessage)`

Métodos protegidos
`void`	`checkAndFlashBaseband(ITestDevice device, IDeviceBuildInfo deviceBuild)` Se necessário, atualize a imagem da banda de base no dispositivo.
`boolean`	`checkAndFlashBootloader(ITestDevice device, IDeviceBuildInfo deviceBuild)` Se necessário, atualize a imagem do carregador de inicialização no dispositivo.
`boolean`	`checkAndFlashSystem(ITestDevice device, String systemBuildId, String systemBuildFlavor, IDeviceBuildInfo deviceBuild)` Se necessário, transfira a imagem do sistema para o dispositivo.
`boolean`	`checkShouldFlashBaseband(ITestDevice device, IDeviceBuildInfo deviceBuild)` Verifique se a banda de base no dispositivo fornecido precisa ser atualizada.
`IFlashingResourcesParser`	`createFlashingResourcesParser(IDeviceBuildInfo localBuild, DeviceDescriptor descriptor)` Método de fábrica para criar um `IFlashingResourcesParser`.
`void`	`downloadExtraImageFiles(IFlashingResourcesParser resourceParser, IFlashingResourcesRetriever retriever, IDeviceBuildInfo localBuild)` Hook para permitir que subclasses baixem arquivos de imagem personalizados extras, se necessário.
`void`	`downloadFlashingResources(ITestDevice device, IDeviceBuildInfo localBuild)` Faz o download dos arquivos de imagem de atualização extras necessários
`String`	`executeFastbootCmd(ITestDevice device, String... cmdArgs)` Método auxiliar para executar o comando fastboot.
`String`	`executeLongFastbootCmd(ITestDevice device, String... cmdArgs)` Método auxiliar para executar um comando fastboot de longa duração.
`String`	`executeLongFastbootCmd(ITestDevice device, envVarMap, String... cmdArgs)` Método auxiliar para executar um comando fastboot de longa duração com variáveis de ambiente.
`void`	`flashBaseband(ITestDevice device, File basebandImageFile)` Faz o flash da imagem de banda de base especificada e reinicializa o carregador de inicialização.
`void`	`flashBootloader(ITestDevice device, File bootloaderImageFile)` Faz o flash da imagem do carregador de inicialização especificada e reinicializa no carregador de inicialização.
`void`	`flashExtraImages(ITestDevice device, IDeviceBuildInfo deviceBuild)` Atualize todas as partições específicas do dispositivo antes de atualizar o sistema e reiniciar.
`void`	`flashPartition(ITestDevice device, File imgFile, String partition)` Atualizar uma partição individual de um dispositivo
`void`	`flashRamdiskIfNeeded(ITestDevice device, IDeviceBuildInfo deviceBuild)`
`void`	`flashSystem(ITestDevice device, IDeviceBuildInfo deviceBuild)` Atualize a imagem do sistema no dispositivo.
`void`	`flashUserData(ITestDevice device, IDeviceBuildInfo deviceBuild)` Faça o flash da partição userdata no dispositivo.
`void`	`flashUserDataFromDeviceImageFile(ITestDevice device, IDeviceBuildInfo deviceBuild)` Extrai o userdata.img do arquivo de imagem do dispositivo e o grava no dispositivo.
`String`	`getBootPartitionName()` Receba o nome da partição de inicialização para este dispositivo.
`String`	`getBootloaderFilePrefix(ITestDevice device)` Receba o prefixo do arquivo do carregador de inicialização.
`String`	`getCurrentSlot(ITestDevice device)` Método auxiliar para recuperar o slot atual (para dispositivos compatíveis com A/B).
`IFlashingResourcesRetriever`	`getFlashingResourcesRetriever()`
`FuseUtil`	`getFuseUtil()`
`String`	`getImageVersion(ITestDevice device, String imageName)`
`IRunUtil`	`getRunUtil()` Exposto para testes.
`void`	`handleUserDataFlashing(ITestDevice device, IDeviceBuildInfo deviceBuild)` Processar o flash da partição de dados do usuário/cache
`boolean`	`hasPartition(ITestDevice device, String partition)` Verifica com o carregador de inicialização se a partição especificada existe ou não.
`void`	`preFlashSetup(ITestDevice device, IDeviceBuildInfo deviceBuild)` Faça qualquer outra configuração prévia necessária.
`void`	`setSkipBootloaderVersionCheck(boolean skipBootloaderVersionCheck)`
`void`	`setSkipFastbootFailedMessage(boolean skipFastbootFailedMessage)`
`void`	`setSystemBuildInfo(String systemBuildId, String systemBuildFlavor)`
`void`	`verifyRequiredBoards(ITestDevice device, IFlashingResourcesParser resourceParser, String deviceProductType)` Verifique se o tipo de produto do dispositivo é compatível com o build a ser transferido.
`void`	`wipeCache(ITestDevice device)` Limpe a partição de cache no dispositivo.
`void`	`wipePartition(ITestDevice device, String partition)` Limpe a partição especificada com `fastboot erase <name>`

Constantes

BASEBAND_IMAGE_NAME

public static final String BASEBAND_IMAGE_NAME

Valor da constante: "radio"

Construtores públicos

FastbootDeviceFlasher

public FastbootDeviceFlasher ()

Métodos públicos

fetchImageVersion

public static String fetchImageVersion (IRunUtil runUtil, 
                ITestDevice device, 
                String imageName)

Método auxiliar para receber a versão atual da imagem no dispositivo.

Parâmetros
`runUtil`	`IRunUtil`
`device`	`ITestDevice`: o `ITestDevice` em que executar o comando
`imageName`	`String`: o nome da imagem a ser recebida.

Retorna
`String`	String da saída stdout do comando

Gera
`DeviceNotAvailableException`	se o dispositivo não estiver disponível
`TargetSetupError`	Se o comando fastboot falhar ou não for possível determinar a versão

flash

public void flash (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Atualiza o build no dispositivo.

Retorna imediatamente após a conclusão do flash. Os autores da chamada precisam esperar que o dispositivo fique on-line e disponível antes de prosseguir com o teste.

Parâmetros
`device`	`ITestDevice`: o `ITestDevice` a ser atualizado
`deviceBuild`	`IDeviceBuildInfo`: o `IDeviceBuildInfo` a ser atualizado

Gera
`DeviceNotAvailableException`
`TargetSetupError`

getSystemFlashingStatus

public CommandStatus getSystemFlashingStatus ()

Recupera o status de execução do comando para atualizar as partições do sistema principal.

Se as partições do sistema não forem atualizadas (o sistema já tem o build a ser atualizado), o status do comando poderá ser null.

Retorna
`CommandStatus`

getUserDataFlashOption

public IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

Recebe se a imagem de dados do usuário deve ser mostrada, apagada ou retida.

Retorna
`IDeviceFlasher.UserDataFlashOption`	Se a imagem dos dados do usuário deve ser mostrada, apagada ou retida

overrideDeviceOptions

public void overrideDeviceOptions (ITestDevice device)

Substitui as opções de um dispositivo. Usado para substituir os valores de opção padrão se eles não forem compatíveis com um dispositivo específico.

preFlashOperations

public void preFlashOperations (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Todas as operações e verificações de configuração que precisam ocorrer antes do flash da seção crítica. Nenhuma dessas operações será incluída na seção crítica controlada por simultaneidade.

Parâmetros
`device`	`ITestDevice`: o `ITestDevice` a ser atualizado
`deviceBuild`	`IDeviceBuildInfo`: o `IDeviceBuildInfo` a ser atualizado

Gera
`DeviceNotAvailableException`
`TargetSetupError`

setDataWipeSkipList

public void setDataWipeSkipList ( dataWipeSkipList)

Define a lista de caminhos em /data para evitar a limpeza ao usar ITestsZipInstaller

A granularidade da lista de bloqueio é de filhos diretos de /data.

Parâmetros
`dataWipeSkipList`

setFlashOptions

public void setFlashOptions ( flashOptions)

Define uma lista de opções para transmitir com comandos de flash/atualização.

setFlashingResourcesRetriever

public void setFlashingResourcesRetriever (IFlashingResourcesRetriever retriever)

Define o mecanismo pelo qual o flasher pode recuperar arquivos de recursos para atualização.

Parâmetros
`retriever`	`IFlashingResourcesRetriever`: o `IFlashingResourcesRetriever` a ser usado

setForceSystemFlash

public void setForceSystemFlash (boolean forceSystemFlash)

Define se o sistema sempre deve ser atualizado, mesmo que esteja executando o build atual.

setIncrementalFlashing

public void setIncrementalFlashing (IncrementalImageUtil incrementalUtil)

Parâmetros
`incrementalUtil`	`IncrementalImageUtil`

setRamdiskPartition

public void setRamdiskPartition (String ramdiskPartition)

Define a partição ramdisk

setShouldFlashRamdisk

public void setShouldFlashRamdisk (boolean shouldFlashRamdisk)

Define se um ramdisk adicional precisa ser atualizado após a atualização do dispositivo usando o zip de imagem.

setUserDataFlashOption

public void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

Alterna se a imagem dos dados do usuário deve ser mostrada, apagada ou retida

setWipeTimeout

public void setWipeTimeout (long timeout)

Defina o tempo limite para limpar os dados.

Parâmetros
`timeout`	`long`

shouldFlashRamdisk

public boolean shouldFlashRamdisk ()

Verifica se o flasher está definido para ter um ramdisk adicional que deve ser atualizado após a atualização do dispositivo via zip de imagem

Retorna
`boolean`

shouldSkipBootloaderVersionCheck

public boolean shouldSkipBootloaderVersionCheck ()

Retorna
`boolean`

stderrContainsFailed

public static boolean stderrContainsFailed (String stderr, 
                boolean skipBootloaderVersionCheck)

Parâmetros
`stderr`	`String`
`skipBootloaderVersionCheck`	`boolean`

Retorna
`boolean`

stderrContainsFailed

public static boolean stderrContainsFailed (String stderr, 
                boolean skipBootloaderVersionCheck, 
                boolean skipFastbootFailedMessage)

Parâmetros
`stderr`	`String`
`skipBootloaderVersionCheck`	`boolean`
`skipFastbootFailedMessage`	`boolean`

Retorna
`boolean`

Métodos protegidos

checkAndFlashBaseband

protected void checkAndFlashBaseband (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Se necessário, atualize a imagem da banda de base no dispositivo. Só vai atualizar a banda de base se a versão atual no dispositivo for diferente da versão necessária

Parâmetros
`device`	`ITestDevice`: o `ITestDevice` a ser atualizado
`deviceBuild`	`IDeviceBuildInfo`: o `IDeviceBuildInfo` que contém a imagem da banda de base a ser atualizada

Gera
`DeviceNotAvailableException`	se o dispositivo não estiver disponível
`TargetSetupError`	se houver falha ao atualizar a banda de base

checkAndFlashBootloader

protected boolean checkAndFlashBootloader (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Se necessário, atualize a imagem do carregador de inicialização no dispositivo.

Só vai atualizar o carregador de inicialização se a versão atual no dispositivo for diferente da versão necessária.

Parâmetros
`device`	`ITestDevice`: o `ITestDevice` a ser atualizado
`deviceBuild`	`IDeviceBuildInfo`: o `IDeviceBuildInfo` que contém a imagem do carregador de inicialização a ser atualizada

Retorna
`boolean`	`true` se o carregador de inicialização foi atualizado, `false` se foi ignorado

Gera
`DeviceNotAvailableException`	se o dispositivo não estiver disponível
`TargetSetupError`	se a atualização do carregador de inicialização falhar

checkAndFlashSystem

protected boolean checkAndFlashSystem (ITestDevice device, 
                String systemBuildId, 
                String systemBuildFlavor, 
                IDeviceBuildInfo deviceBuild)

Se necessário, transfira a imagem do sistema para o dispositivo.

Consulte ERROR(/#shouldFlashSystem(String,String,com.android.tradefed.build.IDeviceBuildInfo))

Independente do caminho escolhido, depois da execução do método, o dispositivo precisa inicializar no espaço do usuário.

Parâmetros
`device`	`ITestDevice`: o `ITestDevice` a ser atualizado
`systemBuildId`	`String`: o ID do build atual em execução no dispositivo
`systemBuildFlavor`	`String`: o sabor do build atual em execução no dispositivo.
`deviceBuild`	`IDeviceBuildInfo`: o `IDeviceBuildInfo` que contém a imagem do sistema a ser atualizada

Retorna
`boolean`	`true` se o sistema foi atualizado, `false` se foi ignorado

Gera
`DeviceNotAvailableException`	se o dispositivo não estiver disponível
`TargetSetupError`	se a atualização do carregador de inicialização falhar

checkShouldFlashBaseband

protected boolean checkShouldFlashBaseband (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Verifique se a banda de base no dispositivo fornecido precisa ser atualizada.

Parâmetros
`device`	`ITestDevice`: o `ITestDevice` a ser verificado
`deviceBuild`	`IDeviceBuildInfo`: o `IDeviceBuildInfo` que contém a imagem de banda de base a ser verificada

Retorna
`boolean`

Gera
`DeviceNotAvailableException`	se o dispositivo não estiver disponível
`TargetSetupError`	se houver falha ao atualizar a banda de base.

createFlashingResourcesParser

protected IFlashingResourcesParser createFlashingResourcesParser (IDeviceBuildInfo localBuild, 
                DeviceDescriptor descriptor)

Método de fábrica para criar um IFlashingResourcesParser.

Exposto para testes de unidade.

Parâmetros
`localBuild`	`IDeviceBuildInfo`: o `IDeviceBuildInfo` a ser analisado
`descriptor`	`DeviceDescriptor`: o descritor do dispositivo que está sendo atualizado.

Retorna
`IFlashingResourcesParser`	um `IFlashingResourcesParser` criado pelo método de fábrica.

Gera
	com.android.tradefed.targetprep.TargetSetupError
`TargetSetupError`

downloadExtraImageFiles

protected void downloadExtraImageFiles (IFlashingResourcesParser resourceParser, 
                IFlashingResourcesRetriever retriever, 
                IDeviceBuildInfo localBuild)

Hook para permitir que subclasses baixem arquivos de imagem personalizados extras, se necessário.

Parâmetros
`resourceParser`	`IFlashingResourcesParser`: o `IFlashingResourcesParser`
`retriever`	`IFlashingResourcesRetriever`: o `IFlashingResourcesRetriever`
`localBuild`	`IDeviceBuildInfo`: o `IDeviceBuildInfo`

Gera
	com.android.tradefed.targetprep.TargetSetupError
`TargetSetupError`

downloadFlashingResources

protected void downloadFlashingResources (ITestDevice device, 
                IDeviceBuildInfo localBuild)

Faz o download dos arquivos de imagem de atualização extras necessários

Parâmetros
`device`	`ITestDevice`: o `ITestDevice` para fazer o download de recursos.
`localBuild`	`IDeviceBuildInfo`: o `IDeviceBuildInfo` a ser preenchido. Supõe que o arquivo de imagem do dispositivo já esteja definido

Gera
`DeviceNotAvailableException`	se o dispositivo não estiver disponível
`TargetSetupError`	se não for possível recuperar recursos

executeFastbootCmd

protected String executeFastbootCmd (ITestDevice device, 
                String... cmdArgs)

Método auxiliar para executar o comando fastboot.

Parâmetros
`device`	`ITestDevice`: o `ITestDevice` em que executar o comando
`cmdArgs`	`String`: os argumentos a serem fornecidos ao fastboot.

Retorna
`String`	String a saída stderr do comando se não estiver vazia. Caso contrário, retorna o stdout. Alguns comandos fastboot são estranhos porque despejam a saída para stderr em caso de sucesso.

Gera
`DeviceNotAvailableException`	se o dispositivo não estiver disponível
`TargetSetupError`	Se o comando fastboot falhar

executeLongFastbootCmd

protected String executeLongFastbootCmd (ITestDevice device, 
                String... cmdArgs)

Método auxiliar para executar um comando fastboot de longa duração.

Observação: a maioria dos comandos fastboot normalmente é executada dentro do tempo limite permitido por INativeDevice.executeFastbootCommand(String). No entanto, quando vários dispositivos estão piscando ao mesmo tempo, os comandos fastboot podem levar muito mais tempo do que o normal.

Parâmetros
`device`	`ITestDevice`: o `ITestDevice` em que executar o comando
`cmdArgs`	`String`: os argumentos a serem fornecidos ao fastboot.

Retorna
`String`	String a saída stderr do comando se não estiver vazia. Caso contrário, retorna o stdout. Alguns comandos fastboot são estranhos porque despejam a saída para stderr em caso de sucesso.

Gera
`DeviceNotAvailableException`	se o dispositivo não estiver disponível
`TargetSetupError`	Se o comando fastboot falhar

executeLongFastbootCmd

protected String executeLongFastbootCmd (ITestDevice device, 
                 envVarMap, 
                String... cmdArgs)

Método auxiliar para executar um comando fastboot de longa duração com variáveis de ambiente.

Parâmetros
`device`	`ITestDevice`: o `ITestDevice` em que executar o comando
`envVarMap`	: o mapa que carrega as variáveis de ambiente que precisam ser definidas antes de executar o comando fastboot.
`cmdArgs`	`String`: os argumentos a serem fornecidos ao fastboot.

Retorna
`String`	String a saída stderr do comando se não estiver vazia. Caso contrário, retorna o stdout. Alguns comandos fastboot são estranhos porque despejam a saída para stderr em caso de sucesso.

Gera
`DeviceNotAvailableException`	se o dispositivo não estiver disponível
`TargetSetupError`	Se o comando fastboot falhar

flashBaseband

protected void flashBaseband (ITestDevice device, 
                File basebandImageFile)

Faz o flash da imagem de banda de base especificada e reinicializa no carregador de inicialização

Parâmetros
`device`	`ITestDevice`: o `ITestDevice` a ser atualizado
`basebandImageFile`	`File`: a imagem de banda base `ERROR(/File)`

Gera
`DeviceNotAvailableException`	se o dispositivo não estiver disponível
`TargetSetupError`	se houver falha ao atualizar a banda de base

flashBootloader

protected void flashBootloader (ITestDevice device, 
                File bootloaderImageFile)

Faz o flash da imagem do carregador de inicialização especificada e reinicializa no carregador de inicialização.

Parâmetros
`device`	`ITestDevice`: o `ITestDevice` a ser atualizado
`bootloaderImageFile`	`File`: a imagem do carregador de inicialização `ERROR(/File)`

Gera
`DeviceNotAvailableException`	se o dispositivo não estiver disponível
`TargetSetupError`	se a atualização falhar

flashExtraImages

protected void flashExtraImages (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Atualize todas as partições específicas do dispositivo antes de atualizar o sistema e reiniciar. Nenhuma operação, a menos que seja substituída.

Parâmetros
`device`	`ITestDevice`: o `ITestDevice` a ser atualizado
`deviceBuild`	`IDeviceBuildInfo`: o `IDeviceBuildInfo` que contém os arquivos de build.

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

flashPartition

protected void flashPartition (ITestDevice device, 
                File imgFile, 
                String partition)

Atualizar uma partição individual de um dispositivo

Parâmetros
`device`	`ITestDevice`: o `ITestDevice` a ser atualizado
`imgFile`	`File`: um `ERROR(/File)` que aponta para a imagem a ser mostrada
`partition`	`String`: o nome da partição a ser atualizada

Gera
`DeviceNotAvailableException`
`TargetSetupError`

flashRamdiskIfNeeded

protected void flashRamdiskIfNeeded (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Parâmetros
`device`	`ITestDevice`
`deviceBuild`	`IDeviceBuildInfo`

Gera
`DeviceNotAvailableException`
`TargetSetupError`

flashSystem

protected void flashSystem (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Atualize a imagem do sistema no dispositivo.

Parâmetros
`device`	`ITestDevice`: o `ITestDevice` a ser atualizado
`deviceBuild`	`IDeviceBuildInfo`: o `IDeviceBuildInfo` a ser atualizado

Gera
`DeviceNotAvailableException`	se o dispositivo não estiver disponível
`TargetSetupError`	Se o comando fastboot falhar

flashUserData

protected void flashUserData (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Faça o flash da partição userdata no dispositivo.

Parâmetros
`device`	`ITestDevice`: o `ITestDevice` a ser atualizado
`deviceBuild`	`IDeviceBuildInfo`: o `IDeviceBuildInfo` que contém os arquivos a serem gravados

Gera
`DeviceNotAvailableException`	se o dispositivo não estiver disponível
`TargetSetupError`	se não for possível atualizar os dados do usuário

flashUserDataFromDeviceImageFile

protected void flashUserDataFromDeviceImageFile (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Extrai o userdata.img do arquivo de imagem do dispositivo e o grava no dispositivo.

Parâmetros
`device`	`ITestDevice`: o `ITestDevice` a ser atualizado
`deviceBuild`	`IDeviceBuildInfo`: o `IDeviceBuildInfo` que contém os arquivos a serem gravados

Gera
`DeviceNotAvailableException`	se o dispositivo não estiver disponível
`TargetSetupError`	se não for possível extrair ou atualizar os dados do usuário

getBootPartitionName

protected String getBootPartitionName ()

Receba o nome da partição de inicialização para este dispositivo.

O padrão é "bootloader". As subclasses precisam substituir esse método, se necessário.

Retorna
`String`

getBootloaderFilePrefix

protected String getBootloaderFilePrefix (ITestDevice device)

Receba o prefixo do arquivo do carregador de inicialização.

O valor padrão é getBootPartitionName(). As subclasses precisam substituir esse método, se necessário.

Parâmetros
`device`	`ITestDevice`: o `ITestDevice` a ser atualizado

Retorna
`String`

Gera
`DeviceNotAvailableException`	se o dispositivo não estiver disponível
`TargetSetupError`	se não for possível receber o prefixo

getCurrentSlot

protected String getCurrentSlot (ITestDevice device)

Método auxiliar para recuperar o slot atual (para dispositivos compatíveis com A/B).

Parâmetros
`device`	`ITestDevice`: o `ITestDevice` em que o comando será executado.

Retorna
`String`	"a", "b" ou nulo (se o dispositivo não for compatível com A/B)

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

getFlashingResourcesRetriever

protected IFlashingResourcesRetriever getFlashingResourcesRetriever ()

Retorna
`IFlashingResourcesRetriever`

getFuseUtil

protected FuseUtil getFuseUtil ()

Retorna
`FuseUtil`

getImageVersion

protected String getImageVersion (ITestDevice device, 
                String imageName)

Parâmetros
`device`	`ITestDevice`
`imageName`	`String`

Retorna
`String`

Gera
`DeviceNotAvailableException`
`TargetSetupError`

getRunUtil

protected IRunUtil getRunUtil ()

Exposto para testes.

Retorna
`IRunUtil`

handleUserDataFlashing

protected void handleUserDataFlashing (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Processar o flash da partição de dados do usuário/cache

Parâmetros
`device`	`ITestDevice`: o `ITestDevice` a ser atualizado
`deviceBuild`	`IDeviceBuildInfo`: o `IDeviceBuildInfo` que contém os arquivos a serem gravados

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

hasPartition

protected boolean hasPartition (ITestDevice device, 
                String partition)

Verifica com o carregador de inicialização se a partição especificada existe ou não.

Parâmetros
`device`	`ITestDevice`: o `ITestDevice` em que operar
`partition`	`String`: o nome da partição a ser verificada

Retorna
`boolean`

Gera
`DeviceNotAvailableException`

preFlashSetup

protected void preFlashSetup (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Faça qualquer outra configuração prévia necessária. Nenhuma operação, a menos que seja substituída.

Parâmetros
`device`	`ITestDevice`: o `ITestDevice` a ser preparado
`deviceBuild`	`IDeviceBuildInfo`: o `IDeviceBuildInfo` que contém os arquivos de build.

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

setSkipBootloaderVersionCheck

protected void setSkipBootloaderVersionCheck (boolean skipBootloaderVersionCheck)

Parâmetros
`skipBootloaderVersionCheck`	`boolean`

setSkipFastbootFailedMessage

protected void setSkipFastbootFailedMessage (boolean skipFastbootFailedMessage)

Parâmetros
`skipFastbootFailedMessage`	`boolean`

setSystemBuildInfo

protected void setSystemBuildInfo (String systemBuildId, 
                String systemBuildFlavor)

Parâmetros
`systemBuildId`	`String`
`systemBuildFlavor`	`String`

verifyRequiredBoards

protected void verifyRequiredBoards (ITestDevice device, 
                IFlashingResourcesParser resourceParser, 
                String deviceProductType)

Verifique se o tipo de produto do dispositivo é compatível com o build a ser transferido.

A implementação básica verifica se o deviceProductType está incluído na coleção IFlashingResourcesParser.getRequiredBoards(). As subclasses podem substituir conforme desejado.

Parâmetros
`device`	`ITestDevice`: o `ITestDevice` a ser exibido
`resourceParser`	`IFlashingResourcesParser`: o `IFlashingResourcesParser`
`deviceProductType`	`String`: o tipo de produto do `device`

Gera
`TargetSetupError`	se as informações necessárias da placa da build não corresponderem ao dispositivo;

wipeCache

protected void wipeCache (ITestDevice device)

Limpe a partição de cache no dispositivo.

Parâmetros
`device`	`ITestDevice`: o `ITestDevice` a ser atualizado

Gera
`DeviceNotAvailableException`	se o dispositivo não estiver disponível
`TargetSetupError`	se a limpeza do cache falhar

wipePartition

protected void wipePartition (ITestDevice device, 
                String partition)

Limpe a partição especificada com `fastboot erase <name>`

Parâmetros
`device`	`ITestDevice`: o `ITestDevice` em que operar
`partition`	`String`: o nome da partição a ser apagada

Gera
`DeviceNotAvailableException`
`TargetSetupError`