IDeviceFlasher

public interface IDeviceFlasher

com.android.tradefed.targetprep.IDeviceFlasher


Atualiza uma imagem do dispositivo.

Resumo

Métodos públicos

abstract void flash(ITestDevice device, IDeviceBuildInfo deviceBuild)

Atualiza o build no dispositivo.

default getAdditionalFileFilters()

Receba filtros para outros artefatos de build.

abstract CommandStatus getSystemFlashingStatus()

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

abstract IDeviceFlasher.UserDataFlashOption getUserDataFlashOption()

Recebe se a imagem de dados do usuário precisa ser atualizada, apagada ou mantida

abstract void overrideDeviceOptions(ITestDevice device)

Substituir opções de um dispositivo.

default void postFlashOperations(ITestDevice device, IDeviceBuildInfo deviceBuild)

Todas as operações e verificações de limpeza que precisam ocorrer após a seção crítica de flash real.

default void preFlashOperations(ITestDevice device, IDeviceBuildInfo deviceBuild)

Todas as operações e verificações de configuração que precisam ocorrer antes da seção crítica de flash real.

abstract void setDataWipeSkipList( dataWipeSkipList)

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

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

abstract void setFlashingResourcesRetriever(IFlashingResourcesRetriever retriever)

Define o mecanismo pelo qual o flasher pode recuperar arquivos de recursos para atualizar.

abstract void setForceSystemFlash(boolean forceSystemFlash)

Define se o sistema precisa ser sempre atualizado mesmo que o build atual esteja em execução

default void setRamdiskPartition(String ramdiskPartition)

Define a partição do ramdisk

default void setShouldFlashRamdisk(boolean shouldFlashRamdisk)

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

abstract void setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption)

Alternar se a imagem de dados do usuário precisa ser atualizada, apagada ou retida

abstract void setWipeTimeout(long timeout)

Defina o tempo limite para apagar os dados.

default boolean shouldFlashRamdisk()

Verifica se o flasher está definido para ter um ramdisk adicional que precisa ser gravado após a atualização do dispositivo por zíper de imagem.

default boolean supportsFlashingInFastbootD()

Se o dispositivo que implementa o flasher pode ser atualizado no modo fastboot.

default void tearDownFlasher()

Última oportunidade para a implementação do flasher limpar a si mesma

Métodos públicos

flash

public abstract 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 até que o dispositivo esteja on-line e disponível antes de prosseguir com o teste.

Parâmetros
device ITestDevice: o ITestDevice a ser exibido

deviceBuild IDeviceBuildInfo: o IDeviceBuildInfo a ser exibido

Gera
TargetSetupError if failed to flash build
DeviceNotAvailableException se o dispositivo não responder

getAdditionalFileFilters

public  getAdditionalFileFilters ()

Receba filtros para outros artefatos de build.

Alguns flashers precisam de determinados artefatos de build que não estão entre os usados por padrão. Esses flashers precisam substituir esse método para que todos os usuários das ferramentas de flash não precisem conhecer esses arquivos e fornecer opções de linha de comando.

Esse método é invocado em uma instância temporária do IDeviceFlasher. Portanto, não confie em nenhum estado além daquele fornecido no construtor padrão.

As strings no conjunto são interpretadas como padrões de arquivo, e todos os arquivos que correspondem ao padrão serão recuperados.

Por padrão, esse método retorna um conjunto vazio.

Retorna

getSystemFlashingStatus

public abstract CommandStatus getSystemFlashingStatus ()

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

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

Retorna
CommandStatus

getUserDataFlashOption

public abstract IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

Consegue se a imagem de dados do usuário precisa ser atualizada, apagada ou retida

Retorna
IDeviceFlasher.UserDataFlashOption Se a imagem dos dados do usuário precisa ser atualizada, apagada ou retida

overrideDeviceOptions

public abstract void overrideDeviceOptions (ITestDevice device)

Substituir opções de um dispositivo. Usado para substituir os valores de opções padrão se eles não tiverem suporte de um dispositivo específico.

postFlashOperations

public void postFlashOperations (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Todas as operações e verificações de limpeza que precisam ocorrer após a seção crítica de flash real. Nenhuma dessas operações será incluída na seção crítica controlada pela simultaneidade.

Parâmetros
device ITestDevice: o ITestDevice a ser exibido

deviceBuild IDeviceBuildInfo: o IDeviceBuildInfo a ser exibido

Gera
TargetSetupError se alguma configuração falhar
DeviceNotAvailableException se o dispositivo não responder

preFlashOperations

public void preFlashOperations (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

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

Parâmetros
device ITestDevice: o ITestDevice a ser exibido

deviceBuild IDeviceBuildInfo: o IDeviceBuildInfo a ser exibido

Gera
TargetSetupError se alguma configuração falhar
DeviceNotAvailableException se o dispositivo não responder

setDataWipeSkipList

public abstract void setDataWipeSkipList ( dataWipeSkipList)

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

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

Parâmetros
dataWipeSkipList

setFlashingResourcesRetriever

public abstract void setFlashingResourcesRetriever (IFlashingResourcesRetriever retriever)

Define o mecanismo pelo qual o flasher pode recuperar arquivos de recursos para atualizar.

Parâmetros
retriever IFlashingResourcesRetriever: o IFlashingResourcesRetriever a ser usado

setForceSystemFlash

public abstract void setForceSystemFlash (boolean forceSystemFlash)

Define se o sistema precisa ser sempre atualizado mesmo que o build atual esteja em execução

setRamdiskPartition

public void setRamdiskPartition (String ramdiskPartition)

Define a partição do ramdisk

setShouldFlashRamdisk

public void setShouldFlashRamdisk (boolean shouldFlashRamdisk)

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

setUserDataFlashOption

public abstract void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

Alternar se a imagem de dados do usuário precisa ser atualizada, apagada ou retida

setWipeTimeout

public abstract void setWipeTimeout (long timeout)

Defina o tempo limite para apagar os dados.

Parâmetros
timeout long

shouldFlashRamdisk

public boolean shouldFlashRamdisk ()

Verifica se o flasher está definido para ter um ramdisk adicional que precisa ser gravado após a atualização do dispositivo por zíper de imagem.

Retorna
boolean

supportsFlashingInFastbootD

public boolean supportsFlashingInFastbootD ()

Se o dispositivo que implementa o flasher pode ser atualizado no modo fastboot.

Retorna
boolean

tearDownFlasher

public void tearDownFlasher ()

Última oportunidade para a implementação do flasher limpar a si mesma