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 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 atualização real da seção crítica. |
abstract
void
|
setDataWipeSkipList(
Define a lista de caminhos em
A granularidade da lista de saltos é de filhos diretos de |
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 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 apagar os dados. |
default
boolean
|
shouldFlashRamdisk()
Verifica se o flasher está configurado para ter um ramdisk adicional precisa ser atualizado depois de atualizar o dispositivo pelo ZIP da 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 precisam esperar até que o dispositivo esteja on-line e disponível antes de prosseguir com o teste.
| Parâmetros | |
|---|---|
device |
ITestDevice: o ITestDevice que será atualizado |
deviceBuild |
IDeviceBuildInfo: o IDeviceBuildInfo a ser exibido |
| Gera | |
|---|---|
TargetSetupError |
if failed to flash build |
DeviceNotAvailableException |
se o dispositivo deixar de responder |
getAdditionalFileFilters
publicgetAdditionalFileFilters ()
Receba filtros para outros artefatos de versão.
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.
Observe que esse método é invocado em uma instância temporária do IDeviceFlasher. Portanto, nenhum estado além do fornecido no construtor padrão deve ser confiável.
As strings no conjunto são interpretadas como padrões de arquivo, e todos os arquivos que correspondem ao padrão são recuperados.
Por padrão, esse método retorna um conjunto vazio.
| Retorna | |
|---|---|
|
|
getSystemFlashingStatus
public abstract CommandStatus getSystemFlashingStatus ()
Recupere 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á tiver o build a ser atualizado),
o status do comando poderá 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)
Substitua 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 a atualização em uma seção crítica real. Nenhuma dessas operações será incluída na seção crítica controlada por simultaneidade.
| Parâmetros | |
|---|---|
device |
ITestDevice: o ITestDevice a ser exibido |
deviceBuild |
IDeviceBuildInfo: o IDeviceBuildInfo que 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 da seção crítica de flash real. Nenhuma dessas operações será incluída na seção crítica controlada por simultaneidade.
| Parâmetros | |
|---|---|
device |
ITestDevice: o ITestDevice a ser exibido |
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 em /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 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 se estiver executando o build atual
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)
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 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 atualizado após a atualização do dispositivo por zip de imagem.
| Retorna | |
|---|---|
boolean |
|
supportsFlashingInFastbootD
public boolean supportsFlashingInFastbootD ()
Se o dispositivo que implementa o flasher pode ser atualizado no modo fastbootd.
| Retorna | |
|---|---|
boolean |
|