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()
Recebe filtros para outros artefatos de build. |
abstract
CommandStatus
|
getSystemFlashingStatus()
Recupera o status de execução do comando para atualizar as partições do sistema principal. |
abstract
IDeviceFlasher.UserDataFlashOption
|
getUserDataFlashOption()
Recebe se a imagem de dados do usuário deve ser mostrada, apagada ou retida. |
abstract
void
|
overrideDeviceOptions(ITestDevice device)
Substitui as 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 o flash da seção crítica. |
default
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. |
abstract
void
|
setDataWipeSkipList(
Define a lista de caminhos em
A granularidade da lista de bloqueio é de filhos diretos de |
default
void
|
setExtraMetadata(
Permite que o flasher receba opções extras de metadados. |
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 sempre deve ser atualizado, mesmo que esteja executando o build atual. |
default
void
|
setRamdiskPartition(String ramdiskPartition)
Define a partição ramdisk |
default
void
|
setShouldFlashRamdisk(boolean shouldFlashRamdisk)
Define se um ramdisk adicional precisa ser atualizado após a atualização do dispositivo usando o zip de imagem. |
abstract
void
|
setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption)
Alterna se a imagem dos dados do usuário deve ser mostrada, apagada ou retida |
abstract
void
|
setWipeTimeout(long timeout)
Defina o tempo limite para limpar os dados. |
default
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 |
default
boolean
|
supportsFlashingInFastbootD()
Se o dispositivo que implementa o flasher pode ser atualizado no modo fastbootd. |
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 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 | |
|---|---|
TargetSetupError |
se a atualização do build falhar |
DeviceNotAvailableException |
se o dispositivo não responder |
getAdditionalFileFilters
publicgetAdditionalFileFilters ()
Recebe filtros para outros artefatos de build.
Alguns flashers precisam de determinados artefatos de build que não estão entre os padrões usados. Esses flashers precisam substituir esse método para que todos os usuários das ferramentas de atualização não precisem saber sobre 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 do 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 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 abstract 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 abstract 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.
postFlashOperations
public void postFlashOperations (ITestDevice device, IDeviceBuildInfo deviceBuild)
Todas as operações e verificações de limpeza que precisam ocorrer após o 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 | |
|---|---|
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 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 | |
|---|---|
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 bloqueio é de filhos diretos de /data.
| Parâmetros | |
|---|---|
dataWipeSkipList |
|
setExtraMetadata
public void setExtraMetadata (metadata)
Permite que o flasher receba opções extras de metadados.
| Parâmetros | |
|---|---|
metadata |
|
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 sempre deve ser atualizado, mesmo que esteja executando o build atual.
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 abstract void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)
Alterna se a imagem dos dados do usuário deve ser mostrada, apagada ou retida
setWipeTimeout
public abstract 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 |
|
supportsFlashingInFastbootD
public boolean supportsFlashingInFastbootD ()
Se o dispositivo que implementa o flasher pode ser atualizado no modo fastbootd.
| Retorna | |
|---|---|
boolean |
|
tearDownFlasher
public void tearDownFlasher ()
Última oportunidade para a implementação do flasher fazer a limpeza