Em 2026, para nos alinharmos ao nosso modelo de desenvolvimento estável 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, use android-latest-release. A ramificação de manifesto android-latest-release sempre vai referenciar a versão mais recente enviada ao AOSP. Para mais informações, consulte Mudanças no AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

SystemUpdaterDeviceFlasher

public class SystemUpdaterDeviceFlasher
extends Object implements IDeviceFlasher

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

Um IDeviceFlasher que depende do atualizador do sistema para instalar uma imagem do sistema agrupada em um pacote de atualização OTA. Em particular, essa implementação não depende do fastboot.

Resumo

Construtores públicos
`SystemUpdaterDeviceFlasher()`

Métodos públicos
`void`	`flash(ITestDevice device, IDeviceBuildInfo deviceBuild)` Atualiza o build no dispositivo. Essa implementação pressupõe que o arquivo de imagem do dispositivo retornado por `IDeviceBuildInfo.getDeviceImageFile()` seja um arquivo zip de atualização OTA.
`CommandStatus`	`getSystemFlashingStatus()` Recupera o status de execução do comando para atualizar as partições principais do sistema.
`IDeviceFlasher.UserDataFlashOption`	`getUserDataFlashOption()` Recebe se a imagem de dados do usuário precisa ser atualizada, limpa ou mantida
`void`	`overrideDeviceOptions(ITestDevice device)` Substitui as opções de um dispositivo.
`void`	`setDataWipeSkipList(Collection<String> dataWipeSkipList)` Define a lista de caminhos em `/data` para evitar a limpeza ao usar `ITestsZipInstaller` A granularidade da lista de ignorados é de filhos diretos de `/data`.
`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 precisa ser atualizado, mesmo que esteja executando o build atual
`void`	`setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption)` Alterna se a imagem de dados do usuário precisa ser atualizada, limpa ou mantida Essa implementação só oferece suporte a `IDeviceFlasher.UserDataFlashOption.TESTS_ZIP` e `IDeviceFlasher.UserDataFlashOption.RETAIN` como opções válidas
`void`	`setWipeTimeout(long timeout)` Define o tempo limite para limpar os dados.

Construtores públicos

SystemUpdaterDeviceFlasher

public SystemUpdaterDeviceFlasher ()

Métodos públicos

flash

public void flash (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Atualiza o build no dispositivo.

Retorna imediatamente após a conclusão da atualização. Os autores da chamada precisam esperar que o dispositivo esteja on-line e disponível antes de prosseguir com os testes.

Essa implementação pressupõe que o arquivo de imagem do dispositivo retornado por IDeviceBuildInfo.getDeviceImageFile() seja um arquivo zip de atualização OTA. Não é seguro usar esse atualizador em um contexto em que essa interpretação não seja válida.

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

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

getSystemFlashingStatus

public CommandStatus getSystemFlashingStatus ()

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

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 precisa ser atualizada, limpa ou mantida

Retorna
`IDeviceFlasher.UserDataFlashOption`	Se a imagem de dados do usuário precisa ser atualizada, limpa ou mantida

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.

setDataWipeSkipList

public void setDataWipeSkipList (Collection<String> dataWipeSkipList)

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

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

Parâmetros
`dataWipeSkipList`	`Collection`

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 precisa ser atualizado, mesmo que esteja executando o build atual

setUserDataFlashOption

public void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

Alterna se a imagem de dados do usuário precisa ser atualizada, limpa ou mantida

Essa implementação só oferece suporte a IDeviceFlasher.UserDataFlashOption.TESTS_ZIP e IDeviceFlasher.UserDataFlashOption.RETAIN como opções válidas

setWipeTimeout

public void setWipeTimeout (long timeout)

Define o tempo limite para limpar os dados.

Parâmetros
`timeout`	`long`