IDeviceFlasher

public interface IDeviceFlasher

com.android.tradefed.targetprep.IDeviceFlasher


Esegue il flashing di un'immagine del dispositivo su un dispositivo.

Riepilogo

Metodi pubblici

abstract void flash(ITestDevice device, IDeviceBuildInfo deviceBuild)

La compilazione lampeggia sul dispositivo.

default getAdditionalFileFilters()

Visualizza i filtri per altri artefatti di compilazione.

abstract CommandStatus getSystemFlashingStatus()

Recupera lo stato di esecuzione del comando per il flashing delle partizioni di sistema principali.

abstract IDeviceFlasher.UserDataFlashOption getUserDataFlashOption()

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

abstract void overrideDeviceOptions(ITestDevice device)

Sostituisci le opzioni 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 e i controlli di configurazione che devono essere eseguiti prima della sezione critica del flashing effettivo.

abstract void setDataWipeSkipList( dataWipeSkipList)

Imposta l'elenco di percorsi in /data per evitare l'eliminazione quando si utilizza ITestsZipInstaller

Tieni presente che la granularità dell'elenco di esclusione è costituita da elementi secondari diretti di /data.

abstract void setFlashingResourcesRetriever(IFlashingResourcesRetriever retriever)

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

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 l'immagine ZIP

abstract void setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption)

Attiva/disattiva se l'immagine dei dati utente deve essere flashata, cancellata o conservata

abstract void setWipeTimeout(long timeout)

Imposta il timeout per l'eliminazione 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 programma di flashing può essere sottoposto a flashing in modalità fastbootd.

default void tearDownFlasher()

Ultima opportunità per l'implementazione del programma di aggiornamento di pulire dopo di sé

Metodi pubblici

flash

public abstract void flash (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

La compilazione lampeggia sul dispositivo.

Rientra immediatamente al termine 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: il IDeviceBuildInfo da 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 elementi di build che non sono tra quelli predefiniti utilizzati. 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 nell'insieme vengono interpretate come pattern di file e tutti i file corrispondenti al pattern verranno recuperati.

Per impostazione predefinita, questo metodo restituisce un Set vuoto.

Ritorni

getSystemFlashingStatus

public abstract CommandStatus getSystemFlashingStatus ()

Recupera lo stato di esecuzione del comando per il flashing delle partizioni di sistema principali.

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

Ritorni
CommandStatus

getUserDataFlashOption

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 flashata, resettata o conservata

overrideDeviceOptions

public abstract void overrideDeviceOptions (ITestDevice device)

Sostituisci le opzioni per un dispositivo. Viene utilizzato per sostituire i valori predefiniti delle opzioni se non sono supportati da un determinato dispositivo.

postFlashOperations

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 Se la configurazione non va a buon fine
DeviceNotAvailableException Se il dispositivo non risponde

preFlashOperations

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: il ITestDevice da lampeggiare

deviceBuild IDeviceBuildInfo: il IDeviceBuildInfo da lampeggiare

Lanci
TargetSetupError Se la configurazione non va a buon fine
DeviceNotAvailableException Se il dispositivo non risponde

setDataWipeSkipList

public abstract void setDataWipeSkipList ( dataWipeSkipList)

Imposta l'elenco di percorsi in /data per evitare l'eliminazione quando si utilizza ITestsZipInstaller

Tieni presente che la granularità dell'elenco di esclusione è costituita da elementi secondari diretti 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 del ramdisk

setShouldFlashRamdisk

public void setShouldFlashRamdisk (boolean shouldFlashRamdisk)

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

setUserDataFlashOption

public abstract void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

Attiva/disattiva se l'immagine dei dati utente deve essere flashata, cancellata o conservata

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

tearDownFlasher

public void tearDownFlasher ()

Ultima opportunità per l'implementazione del programma di aggiornamento di pulire dopo di sé