IDeviceFlasher

public interface IDeviceFlasher

com.android.tradefed.targetprep.IDeviceFlasher


Mostra l'immagine di un dispositivo su un dispositivo.

Riepilogo

Metodi pubblici

abstract void flash(ITestDevice device, IDeviceBuildInfo deviceBuild)

Flash integrati sul dispositivo.

default getAdditionalFileFilters()

Ottieni filtri per ulteriori artefatti della build.

abstract CommandStatus getSystemFlashingStatus()

Recupera lo stato di esecuzione del comando per le partizioni di sistema principali lampeggianti.

abstract IDeviceFlasher.UserDataFlashOption getUserDataFlashOption()

Indica se l'immagine dei dati utente deve essere lampeggiata, cancellata o conservata.

abstract void overrideDeviceOptions(ITestDevice device)

Opzioni di override per un dispositivo.

default void postFlashOperations(ITestDevice device, IDeviceBuildInfo deviceBuild)

Tutte le operazioni di pulizia e i controlli che devono essere eseguiti dopo la sezione critica del flashing effettivo.

default void preFlashOperations(ITestDevice device, IDeviceBuildInfo deviceBuild)

Tutte le operazioni di configurazione e i controlli che devono essere eseguiti prima della sezione critica del flashing effettivo.

abstract void setDataWipeSkipList( dataWipeSkipList)

Imposta l'elenco di percorsi in /data per evitare che vengano cancellati quando utilizzi ITestsZipInstaller

Tieni presente che la granularità della skip list è associata all'elemento secondario diretto di /data.

abstract void setFlashingResourcesRetriever(IFlashingResourcesRetriever retriever)

Imposta il meccanismo mediante il quale il flasher può recuperare i file di risorse per il flashing.

abstract void setForceSystemFlash(boolean forceSystemFlash)

Imposta se il sistema deve essere sempre sottoposto a flashing anche se è in esecuzione la build corrente

default void setRamdiskPartition(String ramdiskPartition)

Imposta la partizione del ramdisk

default void setShouldFlashRamdisk(boolean shouldFlashRamdisk)

Imposta se deve essere eseguito il flashing di un ramdisk aggiuntivo dopo l'aggiornamento del dispositivo tramite file ZIP dell'immagine

abstract void setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption)

Consente di attivare/disattivare l'opzione di flash, cancellazione o conservazione dell'immagine dei dati utente

abstract void setWipeTimeout(long timeout)

Imposta il timeout per la cancellazione dei dati.

default boolean shouldFlashRamdisk()

Controlla se il programma di aggiornamento è impostato per avere un ramdisk aggiuntivo da eseguire dopo l'aggiornamento del dispositivo tramite file ZIP dell'immagine

default boolean supportsFlashingInFastbootD()

Indica se il dispositivo che implementa il flasher può essere flashato in modalità fastbootd.

Metodi pubblici

flash

public abstract void flash (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Flash integrati sul dispositivo.

Restituisce immediatamente dopo il completamento del flashing. Gli utenti che chiamano devono attendere che il dispositivo sia online e disponibile prima di procedere con il test.

Parametri
device ITestDevice: il ITestDevice da lampeggiare

deviceBuild IDeviceBuildInfo: IDeviceBuildInfo da far lampeggiare

Lanci
TargetSetupError if failed to flash build
DeviceNotAvailableException se il dispositivo non risponde

getAdditionalFileFilters

public  getAdditionalFileFilters ()

Visualizza i filtri per altri artefatti di compilazione.

Alcuni flasher richiedono determinati artefatti della build che non sono tra quelli predefiniti. Questi bootloader dovrebbero sostituire questo metodo, in modo che ogni utente degli strumenti di flashing non debba conoscere questi file e fornire opzioni a riga di comando.

Tieni presente che questo metodo viene invocato su un'istanza temporanea di IDeviceFlasher, pertanto non è possibile fare affidamento su nessun stato oltre a quello fornito nel costruttore predefinito.

Le stringhe nel set vengono interpretate come pattern di file e tutti i file corrispondenti al pattern verranno recuperati.

Per impostazione predefinita, questo metodo restituisce un valore Set vuoto.

Ritorni

getSystemFlashingStatus

public abstract CommandStatus getSystemFlashingStatus ()

Recupera lo stato di esecuzione del comando per le partizioni di sistema principali lampeggianti.

Tieni presente che se le partizioni di sistema non vengono sottoposte a flashing (il sistema ha già la build da eseguire il flashing), lo stato del comando potrebbe essere null

Ritorni
CommandStatus

Opzione getUserDataFlash

public abstract IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

Indica se l'immagine dei dati utente deve essere flashata, resettata o conservata

Ritorni
IDeviceFlasher.UserDataFlashOption Indica se l'immagine dei dati utente deve essere lampeggiata, cancellata o conservata.

overrideDeviceOptions

public abstract void overrideDeviceOptions (ITestDevice device)

Opzioni di override per un dispositivo. Utilizzato per eseguire l'override dei valori predefiniti delle opzioni se i valori predefiniti non sono supportati da un determinato dispositivo.

operazioni postFlash

public void postFlashOperations (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Tutte le operazioni di pulizia e i controlli che devono essere eseguiti dopo la sezione critica del flashing effettivo. Nessuna di queste operazioni verrà inclusa nella sezione critica controllata dalla concorrenza.

Parametri
device ITestDevice: il ITestDevice da lampeggiare

deviceBuild IDeviceBuildInfo: il IDeviceBuildInfo da lampeggiare

Lanci
TargetSetupError in caso di problemi di configurazione
DeviceNotAvailableException se il dispositivo non risponde

operazioni preFlash

public void preFlashOperations (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Tutte le operazioni e i controlli di configurazione che devono essere eseguiti prima della sezione critica del flashing effettivo. Nessuna di queste operazioni verrà inclusa nella sezione critica controllata dalla concorrenza.

Parametri
device ITestDevice: ITestDevice da far lampeggiare

deviceBuild IDeviceBuildInfo: il IDeviceBuildInfo da lampeggiare

Lanci
TargetSetupError in caso di problemi di configurazione
DeviceNotAvailableException se il dispositivo non risponde

setDataWipeSkipList

public abstract void setDataWipeSkipList ( dataWipeSkipList)

Imposta l'elenco di percorsi in /data per evitare che vengano cancellati quando utilizzi ITestsZipInstaller

Tieni presente che la granularità della skip list è associata all'elemento secondario diretto di /data.

Parametri
dataWipeSkipList

setFlashingResourcesRetriever

public abstract void setFlashingResourcesRetriever (IFlashingResourcesRetriever retriever)

Imposta il meccanismo mediante il quale il programma di aggiornamento può recuperare i file di risorse per il flashing.

Parametri
retriever IFlashingResourcesRetriever: il IFlashingResourcesRetriever da utilizzare

setForceSystemFlash

public abstract void setForceSystemFlash (boolean forceSystemFlash)

Imposta se il sistema deve essere sempre sottoposto a flashing anche se è in esecuzione la build corrente

setRamdiskPartition

public void setRamdiskPartition (String ramdiskPartition)

Imposta la partizione ramdisk

setShouldFlashRamdisk

public void setShouldFlashRamdisk (boolean shouldFlashRamdisk)

Imposta se deve essere eseguito il flashing di un ramdisk aggiuntivo dopo l'aggiornamento del dispositivo tramite image zip

setUserDataFlashOption

public abstract void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

Consente di attivare/disattivare l'opzione di flash, cancellazione o conservazione dell'immagine dei dati utente

setWipeTimeout

public abstract void setWipeTimeout (long timeout)

Imposta il timeout per l'eliminazione dei dati.

Parametri
timeout long

shouldFlashRamdisk

public boolean shouldFlashRamdisk ()

Controlla se il programma di aggiornamento è impostato per avere un ramdisk aggiuntivo da eseguire dopo l'aggiornamento del dispositivo tramite file ZIP dell'immagine

Ritorni
boolean

supportsFlashingInFastbootD

public boolean supportsFlashingInFastbootD ()

Indica se il dispositivo che implementa il programma di flashing può essere sottoposto a flashing in modalità fastbootd.

Ritorni
boolean