IDeviceFlasher

public interface IDeviceFlasher

com.android.tradefed.targetprep.IDeviceFlasher


Atualiza uma imagem de dispositivo em um 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 versão.

abstract CommandStatus getSystemFlashingStatus()

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

abstract IDeviceFlasher.UserDataFlashOption getUserDataFlashOption()

Descobre se a imagem de dados do usuário deve ser atualizada, apagada ou retida

abstract void overrideDeviceOptions(ITestDevice device)

Opções de modificação para um dispositivo.

default void postFlashOperations(ITestDevice device, IDeviceBuildInfo deviceBuild)

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

default void preFlashOperations(ITestDevice device, IDeviceBuildInfo deviceBuild)

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

abstract void setDataWipeSkipList( dataWipeSkipList)

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

A granularidade da lista de pulos é filhas diretas de /data.

abstract void setFlashingResourcesRetriever(IFlashingResourcesRetriever retriever)

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

abstract void setForceSystemFlash(boolean forceSystemFlash)

Define se o sistema precisa ser sempre atualizado, mesmo se o build atual estiver 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 usando um ZIP de imagem

abstract void setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption)

Alterna se a imagem de dados do usuário deve ser atualizada, apagada ou retida

abstract void setWipeTimeout(long timeout)

Defina o tempo limite para a exclusão permanente dos dados.

default boolean shouldFlashRamdisk()

Verifica se o flasher está configurado para ter um ramdisk adicional deve ser atualizado após a atualização dispositivo com ZIP de imagem

default boolean supportsFlashingInFastbootD()

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

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

Parâmetros
device ITestDevice: o ITestDevice que será atualizado

deviceBuild IDeviceBuildInfo: o IDeviceBuildInfo que será atualizado

Gera
TargetSetupError se não for possível atualizar o build
DeviceNotAvailableException se o dispositivo deixar de responder

getAdditionalFileFilters

public  getAdditionalFileFilters ()

Receba filtros para outros artefatos de versão.

Alguns flashers precisam de certos artefatos de build que não estão entre os padrão usados. Essas os flashes devem substituir esse método, de modo que cada usuário das ferramentas de atualização não precise sobre esses arquivos e fornecer opções de linha de comando.

Observe que esse método é invocado em uma instância temporária do IDeviceFlasher, portanto além do fornecido no construtor padrão deve ser confiável.

Strings no Set 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 Set vazio.

Retorna

getSystemFlashingStatus

public abstract CommandStatus getSystemFlashingStatus ()

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

Observe que, se as partições do sistema não forem atualizadas (o sistema já tem o build para atualização) o status do comando pode ser null

Retorna
CommandStatus

getUserDataFlashOption

public abstract IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

Descobre se a imagem de dados do usuário deve ser atualizada, apagada ou retida

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

substituirDeviceOptions

public abstract void overrideDeviceOptions (ITestDevice device)

Opções de modificação para um dispositivo. Usado para substituir os valores de opção padrão se os padrões não forem suportado por determinado dispositivo.

postFlashOperations

public void postFlashOperations (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Todas as operações de limpeza e que devem ocorrer após a seção crítica de atualização real. Nenhuma dessas operações serão incluídas na seção crítica controlada por simultaneidade.

Parâmetros
device ITestDevice: o ITestDevice que será atualizado

deviceBuild IDeviceBuildInfo: o IDeviceBuildInfo que será atualizado

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

preFlashOperations

public void preFlashOperations (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Todas as operações e verificações que devem ocorrer antes da seção crítica real de atualização. Nenhuma dessas operações serão incluídas na seção crítica controlada por simultaneidade.

Parâmetros
device ITestDevice: o ITestDevice que será atualizado

deviceBuild IDeviceBuildInfo: o IDeviceBuildInfo que será atualizado

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

setDataWipeSkipList

public abstract void setDataWipeSkipList ( dataWipeSkipList)

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

A granularidade da lista de pulos é filhas diretas 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 atualização.

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 se o build atual estiver 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 usando um ZIP de imagem

setUserDataFlashOption

public abstract void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

Alterna se a imagem de dados do usuário deve ser atualizada, apagada ou retida

setWipeTimeout

public abstract void setWipeTimeout (long timeout)

Defina o tempo limite para a exclusão permanente dos dados.

Parâmetros
timeout long

shouldFlashRamdisk

public boolean shouldFlashRamdisk ()

Verifica se o flasher está configurado para ter um ramdisk adicional deve ser atualizado após a atualização dispositivo com ZIP de imagem

Retorna
boolean

suporta FlashingInFastbootD

public boolean supportsFlashingInFastbootD ()

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

Retorna
boolean