Google is committed to advancing racial equity for Black communities. See how.
Questa pagina è stata tradotta dall'API Cloud Translation.
Switch to English

FastbootDeviceFlasher

public class FastbootDeviceFlasher
extends Object implements IDeviceFlasher

java.lang.Object
com.android.tradefed.targetprep.FastbootDeviceFlasher


Una classe che si basa su fastboot per eseguire il flashing di un'immagine su hardware Android fisico.

Sommario

Campi

public static final String BASEBAND_IMAGE_NAME

Costruttori pubblici

FastbootDeviceFlasher ()

Metodi pubblici

void flash (ITestDevice device, IDeviceBuildInfo deviceBuild)

I flash si accumulano sul dispositivo.

CommandStatus getSystemFlashingStatus ()

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

IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

Ottiene se l'immagine dei dati utente deve essere visualizzata in flash, cancellata o conservata

void overrideDeviceOptions (ITestDevice device)

Ignora le opzioni per un dispositivo.

void setDataWipeSkipList ( dataWipeSkipList) setDataWipeSkipList ( dataWipeSkipList)

Imposta l'elenco dei percorsi in /data per evitare la cancellazione quando si utilizza ITestsZipInstaller

Si noti che la granularità dell'elenco da saltare è diretta figlio di /data .

void setFlashOptions ( flashOptions) setFlashOptions ( flashOptions)

Imposta un elenco di opzioni da passare con i comandi flash / update.

void setFlashingResourcesRetriever ( IFlashingResourcesRetriever retriever)

Imposta il meccanismo mediante il quale il lampeggiatore può recuperare i file di risorse per il lampeggiamento.

void setForceSystemFlash (boolean forceSystemFlash)

Imposta se il sistema deve essere sempre aggiornato anche se è in esecuzione la build corrente

void setShouldFlashRamdisk (boolean shouldFlashRamdisk)

Imposta se un ramdisk aggiuntivo deve essere aggiornato dopo l'aggiornamento del dispositivo tramite zip immagine

void setUserDataFlashOption ( IDeviceFlasher.UserDataFlashOption flashOption)

Determina se l'immagine dei dati utente debba essere visualizzata in flash, cancellata o conservata

void setWipeTimeout (long timeout)

Imposta il timeout per la cancellazione dei dati.

boolean shouldFlashRamdisk ()

Controlla se il flasher è impostato per avere un ramdisk aggiuntivo che deve essere flashato dopo l'aggiornamento del dispositivo tramite zip immagine

Metodi protetti

void checkAndFlashBaseband (ITestDevice device, IDeviceBuildInfo deviceBuild)

Se necessario, lampeggia l'immagine in banda base sul dispositivo.

boolean checkAndFlashBootloader (ITestDevice device, IDeviceBuildInfo deviceBuild)

Se necessario, esegui il flash dell'immagine del bootloader sul dispositivo.

boolean checkAndFlashSystem (ITestDevice device, String systemBuildId, String systemBuildFlavor, IDeviceBuildInfo deviceBuild)

Se necessario, lampeggia l'immagine del sistema sul dispositivo.

boolean checkShouldFlashBaseband (ITestDevice device, IDeviceBuildInfo deviceBuild)

Verificare se è necessario eseguire il flashing della banda base sul dispositivo fornito.

IFlashingResourcesParser createFlashingResourcesParser ( IDeviceBuildInfo localBuild, DeviceDescriptor descriptor)

Metodo di fabbrica per la creazione di un IFlashingResourcesParser .

void downloadExtraImageFiles ( IFlashingResourcesParser resourceParser, IFlashingResourcesRetriever retriever, IDeviceBuildInfo localBuild)

Hook per consentire alle sottoclassi di scaricare file di immagine personalizzati aggiuntivi, se necessario.

void downloadFlashingResources (ITestDevice device, IDeviceBuildInfo localBuild)

Scarica file immagine lampeggianti aggiuntivi necessari

String executeFastbootCmd (ITestDevice device, String... cmdArgs)

Metodo di supporto per eseguire il comando fastboot.

String executeLongFastbootCmd (ITestDevice device, String... cmdArgs)

Metodo di supporto per eseguire un comando fastboot di lunga durata.

void flashBaseband (ITestDevice device, File basebandImageFile)

Lampeggia l'immagine in banda base data e riavvia nel bootloader

void flashBootloader (ITestDevice device, File bootloaderImageFile)

Esegue il flashing dell'immagine del bootloader data e si riavvia nel bootloader

void flashExtraImages (ITestDevice device, IDeviceBuildInfo deviceBuild)

Eseguire il flashing di qualsiasi partizione specifica del dispositivo prima di eseguire il flashing del sistema e il riavvio.

void flashPartition (ITestDevice device, File imgFile, String partition)

Flash una singola partizione di un dispositivo

void flashRamdiskIfNeeded (ITestDevice device, IDeviceBuildInfo deviceBuild)
void flashSystem (ITestDevice device, IDeviceBuildInfo deviceBuild)

Flash l'immagine di sistema sul dispositivo.

void flashUserData (ITestDevice device, IDeviceBuildInfo deviceBuild)

Flash partizione dei dati utente sul dispositivo.

void flashUserDataFromDeviceImageFile (ITestDevice device, IDeviceBuildInfo deviceBuild)

Estrae userdata.img dal file immagine del dispositivo e lo lampeggia sul dispositivo

String getBootPartitionName ()

Ottieni il nome della partizione di avvio per questo dispositivo lampeggiante.

String getBootloaderFilePrefix (ITestDevice device)

Ottieni il prefisso del file del bootloader.

String getCurrentSlot (ITestDevice device)

Metodo di supporto per recuperare lo slot corrente (per dispositivi compatibili con A / B).

IFlashingResourcesRetriever getFlashingResourcesRetriever ()
String getImageVersion (ITestDevice device, String imageName)

Metodo di supporto per ottenere la versione corrente dell'immagine sul dispositivo.

IRunUtil getRunUtil ()

Esposto per il test.

void handleUserDataFlashing (ITestDevice device, IDeviceBuildInfo deviceBuild)

Gestire il lampeggiamento della partizione dati utente / cache

boolean hasPartition (ITestDevice device, String partition)

Verifica con il bootloader se la partizione specificata esiste o meno

void preFlashSetup (ITestDevice device, IDeviceBuildInfo deviceBuild)

Eseguire qualsiasi configurazione aggiuntiva di prelampeggio richiesta.

void verifyRequiredBoards (ITestDevice device, IFlashingResourcesParser resourceParser, String deviceProductType)

Verificare che il tipo di prodotto del dispositivo supporti la build-to-be-flash.

void wipeCache (ITestDevice device)

Cancella la partizione della cache sul dispositivo.

void wipePartition (ITestDevice device, String partition)

Cancella la partizione specificata con "fastboot erase <nome>"

Campi

BASEBAND_IMAGE_NAME

public static final String BASEBAND_IMAGE_NAME

Costruttori pubblici

FastbootDeviceFlasher

public FastbootDeviceFlasher ()

Metodi pubblici

veloce

public void flash (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

I flash si accumulano sul dispositivo.

Ritorna immediatamente dopo il completamento del lampeggiamento. I chiamanti devono attendere che il dispositivo sia online e disponibile prima di procedere con il test.

Parametri
device ITestDevice : ITestDevice da ITestDevice

deviceBuild IDeviceBuildInfo : IDeviceBuildInfo da lampeggiare

Lancia
DeviceNotAvailableException
TargetSetupError

getSystemFlashingStatus

public CommandStatus getSystemFlashingStatus ()

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

Si noti che se le partizioni di sistema non vengono modificate (il sistema ha già la build da aggiornare) lo stato del comando potrebbe essere null

ritorna
CommandStatus

getUserDataFlashOption

public IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

Ottiene se l'immagine dei dati utente deve essere visualizzata in flash, cancellata o conservata

ritorna
IDeviceFlasher.UserDataFlashOption Indica se l'immagine dei dati utente deve essere visualizzata in flash, cancellata o conservata

overrideDeviceOptions

public void overrideDeviceOptions (ITestDevice device)

Ignora le opzioni per un dispositivo. Utilizzato per sostituire i valori delle opzioni predefinite se i valori predefiniti non sono supportati da un particolare dispositivo.

setDataWipeSkipList

public void setDataWipeSkipList ( dataWipeSkipList)

Imposta l'elenco dei percorsi in /data per evitare la cancellazione quando si utilizza ITestsZipInstaller

Si noti che la granularità dell'elenco da saltare è diretta figlio di /data .

Parametri
dataWipeSkipList

setFlashOptions

public void setFlashOptions ( flashOptions)

Imposta un elenco di opzioni da passare con i comandi flash / update.

setFlashingResourcesRetriever

public void setFlashingResourcesRetriever (IFlashingResourcesRetriever retriever)

Imposta il meccanismo mediante il quale il lampeggiatore può recuperare i file di risorse per il lampeggiamento.

Parametri
retriever IFlashingResourcesRetriever : IFlashingResourcesRetriever da usare

setForceSystemFlash

public void setForceSystemFlash (boolean forceSystemFlash)

Imposta se il sistema deve essere sempre aggiornato anche se è in esecuzione la build corrente

setShouldFlashRamdisk

public void setShouldFlashRamdisk (boolean shouldFlashRamdisk)

Imposta se un ramdisk aggiuntivo deve essere aggiornato dopo l'aggiornamento del dispositivo tramite zip immagine

setUserDataFlashOption

public void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

Determina se l'immagine dei dati utente debba essere visualizzata in flash, cancellata o conservata

setWipeTimeout

public void setWipeTimeout (long timeout)

Imposta il timeout per la cancellazione dei dati.

Parametri
timeout long

shouldFlashRamdisk

public boolean shouldFlashRamdisk ()

Controlla se il flasher è impostato per avere un ramdisk aggiuntivo che deve essere aggiornato dopo l'aggiornamento del dispositivo tramite zip immagine

ritorna
boolean

Metodi protetti

checkAndFlashBaseband

protected void checkAndFlashBaseband (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Se necessario, lampeggia l'immagine in banda base sul dispositivo. Flash baseband solo se la versione corrente sul dispositivo! = Versione richiesta

Parametri
device ITestDevice : ITestDevice da ITestDevice

deviceBuild IDeviceBuildInfo : IDeviceBuildInfo che contiene l'immagine in banda base da lampeggiare

Lancia
DeviceNotAvailableException se il dispositivo non è disponibile
TargetSetupError se non è stato possibile eseguire il flashing della banda base

checkAndFlashBootloader

protected boolean checkAndFlashBootloader (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Se necessario, esegui il flashing dell'immagine del bootloader sul dispositivo.

Flash bootloader solo se la versione corrente sul dispositivo! = Versione richiesta.

Parametri
device ITestDevice : il ITestDevice da lampeggiare

deviceBuild IDeviceBuildInfo : IDeviceBuildInfo che contiene l'immagine del bootloader da lampeggiare

ritorna
boolean true se il bootloader è stato lampeggiante, false se è stato ignorato

Lancia
DeviceNotAvailableException se il dispositivo non è disponibile
TargetSetupError in caso di mancato aggiornamento del bootloader

checkAndFlashSystem

protected boolean checkAndFlashSystem (ITestDevice device, 
                String systemBuildId, 
                String systemBuildFlavor, 
                IDeviceBuildInfo deviceBuild)

Se necessario, lampeggia l'immagine del sistema sul dispositivo.

Si prega di guardare ERROR(/#shouldFlashSystem(String,String,com.android.tradefed.build.IDeviceBuildInfo))

Indipendentemente dal percorso scelto, dopo l'esecuzione del metodo il dispositivo dovrebbe essere avviato nello spazio utente.

Parametri
device ITestDevice : ITestDevice da ITestDevice

systemBuildId String : l'ID build corrente in esecuzione sul dispositivo

systemBuildFlavor String : la versione di build corrente in esecuzione sul dispositivo

deviceBuild IDeviceBuildInfo : IDeviceBuildInfo che contiene l'immagine di sistema da lampeggiare

ritorna
boolean true se il sistema è stato lampeggiante, false se è stato ignorato

Lancia
DeviceNotAvailableException se il dispositivo non è disponibile
TargetSetupError in caso di mancato aggiornamento del bootloader

checkShouldFlashBaseband

protected boolean checkShouldFlashBaseband (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Verificare se è necessario eseguire il flashing della banda base sul dispositivo fornito.

Parametri
device ITestDevice : il ITestDevice da controllare

deviceBuild IDeviceBuildInfo : IDeviceBuildInfo che contiene l'immagine della banda base da controllare

ritorna
boolean

Lancia
DeviceNotAvailableException se il dispositivo non è disponibile
TargetSetupError se non è stato possibile eseguire il flashing della banda base

createFlashingResourcesParser

protected IFlashingResourcesParser createFlashingResourcesParser (IDeviceBuildInfo localBuild, 
                DeviceDescriptor descriptor)

Metodo di fabbrica per la creazione di un IFlashingResourcesParser .

Esposto per unit test.

Parametri
localBuild IDeviceBuildInfo : IDeviceBuildInfo da analizzare

descriptor DeviceDescriptor : il descrittore del dispositivo che si sta DeviceDescriptor il DeviceDescriptor .

ritorna
IFlashingResourcesParser un IFlashingResourcesParser creato dal metodo factory.

Lancia
TargetSetupError

downloadExtraImageFiles

protected void downloadExtraImageFiles (IFlashingResourcesParser resourceParser, 
                IFlashingResourcesRetriever retriever, 
                IDeviceBuildInfo localBuild)

Hook per consentire alle sottoclassi di scaricare file di immagine personalizzati aggiuntivi, se necessario.

Parametri
resourceParser IFlashingResourcesParser : IFlashingResourcesParser

retriever IFlashingResourcesRetriever : IFlashingResourcesRetriever

localBuild IDeviceBuildInfo : IDeviceBuildInfo

Lancia
TargetSetupError

downloadFlashingResources

protected void downloadFlashingResources (ITestDevice device, 
                IDeviceBuildInfo localBuild)

Scarica file immagine lampeggianti aggiuntivi necessari

Parametri
device ITestDevice : ITestDevice per cui scaricare le risorse

localBuild IDeviceBuildInfo : IDeviceBuildInfo da popolare. Presume che il file immagine del dispositivo sia già impostato

Lancia
DeviceNotAvailableException se il dispositivo non è disponibile
TargetSetupError se non è riuscito a recuperare le risorse

executeFastbootCmd

protected String executeFastbootCmd (ITestDevice device, 
                String... cmdArgs)

Metodo di supporto per eseguire il comando fastboot.

Parametri
device ITestDevice : il ITestDevice su cui eseguire il comando

cmdArgs String : gli argomenti da fornire al fastboot

ritorna
String Stringa l'output di stderr dal comando se non è vuoto. Altrimenti restituisce lo stdout Alcuni comandi fastboot sono strani in quanto scaricano l'output su stderr in caso di successo

Lancia
DeviceNotAvailableException se il dispositivo non è disponibile
TargetSetupError se il comando fastboot fallisce

executeLongFastbootCmd

protected String executeLongFastbootCmd (ITestDevice device, 
                String... cmdArgs)

Metodo di supporto per eseguire un comando fastboot di lunga durata.

Nota: la maggior parte dei comandi di ITestDevice#executeFastbootCommand(String...) normalmente vengono eseguiti entro il timeout consentito da ITestDevice#executeFastbootCommand(String...) . Tuttavia, quando più dispositivi stanno lampeggiando dispositivi contemporaneamente, i comandi di avvio rapido possono richiedere molto più tempo del normale.

Parametri
device ITestDevice : il ITestDevice su cui eseguire il comando

cmdArgs String : gli argomenti da fornire al fastboot

ritorna
String Stringa l'output di stderr dal comando se non è vuoto. Altrimenti restituisce lo stdout Alcuni comandi fastboot sono strani in quanto scaricano l'output su stderr in caso di successo

Lancia
DeviceNotAvailableException se il dispositivo non è disponibile
TargetSetupError se il comando fastboot fallisce

flashBaseband

protected void flashBaseband (ITestDevice device, 
                File basebandImageFile)

Lampeggia l'immagine in banda base data e riavvia nel bootloader

Parametri
device ITestDevice : ITestDevice da ITestDevice

basebandImageFile File : ERROR(/File) dell'immagine in banda base ERROR(/File)

Lancia
DeviceNotAvailableException se il dispositivo non è disponibile
TargetSetupError se non è stato possibile eseguire il flashing della banda base

flashBootloader

protected void flashBootloader (ITestDevice device, 
                File bootloaderImageFile)

Lampeggia l'immagine del bootloader data e si riavvia nel bootloader

Parametri
device ITestDevice : il ITestDevice da lampeggiare

bootloaderImageFile File : l'immagine del bootloader ERROR(/File)

Lancia
DeviceNotAvailableException se il dispositivo non è disponibile
TargetSetupError se non è riuscito a lampeggiare

flashExtraImages

protected void flashExtraImages (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Eseguire il flashing di qualsiasi partizione specifica del dispositivo prima di eseguire il flashing del sistema e il riavvio. Nessuna operazione a meno che non venga ignorata.

Parametri
device ITestDevice : ITestDevice da ITestDevice

deviceBuild IDeviceBuildInfo : IDeviceBuildInfo contenente i file di build

Lancia
com.android.tradefed.device.DeviceNotAvailableException
TargetSetupError
DeviceNotAvailableException

flashPartition

protected void flashPartition (ITestDevice device, 
                File imgFile, 
                String partition)

Flash una singola partizione di un dispositivo

Parametri
device ITestDevice : ITestDevice da ITestDevice

imgFile File : un ERROR(/File) punta all'immagine da lampeggiare

partition String : il nome della partizione da lampeggiare

Lancia
DeviceNotAvailableException
TargetSetupError

flashRamdiskIfNeeded

protected void flashRamdiskIfNeeded (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Parametri
device ITestDevice

deviceBuild IDeviceBuildInfo

Lancia
DeviceNotAvailableException
TargetSetupError

flashSystem

protected void flashSystem (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Flash l'immagine di sistema sul dispositivo.

Parametri
device ITestDevice : ITestDevice da ITestDevice

deviceBuild IDeviceBuildInfo : IDeviceBuildInfo da lampeggiare

Lancia
DeviceNotAvailableException se il dispositivo non è disponibile
TargetSetupError se il comando fastboot fallisce

flashUserData

protected void flashUserData (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Flash partizione dei dati utente sul dispositivo.

Parametri
device ITestDevice : ITestDevice da ITestDevice

deviceBuild IDeviceBuildInfo : IDeviceBuildInfo che contiene i file di cui eseguire il flash

Lancia
DeviceNotAvailableException se il dispositivo non è disponibile
TargetSetupError se non è stato possibile eseguire il flashing dei dati utente

flashUserDataFromDeviceImageFile

protected void flashUserDataFromDeviceImageFile (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Estrae userdata.img dal file immagine del dispositivo e lo lampeggia sul dispositivo

Parametri
device ITestDevice : ITestDevice da ITestDevice

deviceBuild IDeviceBuildInfo : IDeviceBuildInfo che contiene i file di cui eseguire il flash

Lancia
DeviceNotAvailableException se il dispositivo non è disponibile
TargetSetupError se non è stato possibile estrarre o eseguire il flashing dei dati utente

getBootPartitionName

protected String getBootPartitionName ()

Ottieni il nome della partizione di avvio per questo dispositivo lampeggiante.

Il valore predefinito è "bootloader". Le sottoclassi dovrebbero sovrascrivere se necessario.

ritorna
String

getBootloaderFilePrefix

protected String getBootloaderFilePrefix (ITestDevice device)

Ottieni il prefisso del file del bootloader.

Il valore predefinito è getBootPartitionName() . Le sottoclassi dovrebbero sovrascrivere se necessario.

Parametri
device ITestDevice : il ITestDevice da lampeggiare

ritorna
String

Lancia
DeviceNotAvailableException se il dispositivo non è disponibile
TargetSetupError se non è riuscito a ottenere il prefisso

getCurrentSlot

protected String getCurrentSlot (ITestDevice device)

Metodo di supporto per recuperare lo slot corrente (per dispositivi compatibili con A / B).

Parametri
device ITestDevice : il ITestDevice su cui eseguire il comando.

ritorna
String "a", "b" o null (se il dispositivo non è compatibile con A / B)

Lancia
com.android.tradefed.device.DeviceNotAvailableException
TargetSetupError
DeviceNotAvailableException

getFlashingResourcesRetriever

protected IFlashingResourcesRetriever getFlashingResourcesRetriever ()

ritorna
IFlashingResourcesRetriever

getImageVersion

protected String getImageVersion (ITestDevice device, 
                String imageName)

Metodo di supporto per ottenere la versione corrente dell'immagine sul dispositivo.

Parametri
device ITestDevice : il ITestDevice su cui eseguire il comando

imageName String : il nome dell'immagine da ottenere.

ritorna
String Stringa l'output di stdout dal comando

Lancia
DeviceNotAvailableException se il dispositivo non è disponibile
TargetSetupError se il comando fastboot fallisce o non è possibile determinare la versione

getRunUtil

protected IRunUtil getRunUtil ()

Esposto per il test.

ritorna
IRunUtil

handleUserDataFlashing

protected void handleUserDataFlashing (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Gestire il lampeggiamento della partizione dati utente / cache

Parametri
device ITestDevice : ITestDevice da ITestDevice

deviceBuild IDeviceBuildInfo : IDeviceBuildInfo che contiene i file di cui eseguire il flash

Lancia
com.android.tradefed.device.DeviceNotAvailableException
TargetSetupError
DeviceNotAvailableException

hasPartition

protected boolean hasPartition (ITestDevice device, 
                String partition)

Verifica con il bootloader se la partizione specificata esiste o meno

Parametri
device ITestDevice : il ITestDevice su cui operare

partition String : il nome della partizione da controllare

ritorna
boolean

Lancia
DeviceNotAvailableException

preFlashSetup

protected void preFlashSetup (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Eseguire qualsiasi configurazione aggiuntiva di prelampeggio richiesta. Nessuna operazione a meno che non venga ignorata.

Parametri
device ITestDevice : il ITestDevice da preparare

deviceBuild IDeviceBuildInfo : IDeviceBuildInfo contenente i file di build

Lancia
com.android.tradefed.device.DeviceNotAvailableException
TargetSetupError
DeviceNotAvailableException

verificareRequiredBoards

protected void verifyRequiredBoards (ITestDevice device, 
                IFlashingResourcesParser resourceParser, 
                String deviceProductType)

Verificare che il tipo di prodotto del dispositivo supporti la build-to-be-flash.

L'implementazione di base verificherà che deviceProductType sia incluso nella IFlashingResourcesParser#getRequiredBoards() . Le sottoclassi possono sovrascrivere come desiderato.

Parametri
device ITestDevice : ITestDevice di cui ITestDevice il ITestDevice

resourceParser IFlashingResourcesParser : IFlashingResourcesParser

deviceProductType String : il tipo di prodotto del device

Lancia
TargetSetupError se le informazioni sulla scheda richieste dalla build non corrispondono al dispositivo

wipeCache

protected void wipeCache (ITestDevice device)

Cancella la partizione della cache sul dispositivo.

Parametri
device ITestDevice : ITestDevice da ITestDevice

Lancia
DeviceNotAvailableException se il dispositivo non è disponibile
TargetSetupError se non è riuscito a eseguire il flashing della cache

cancellare la partizione

protected void wipePartition (ITestDevice device, 
                String partition)

Cancella la partizione specificata con "fastboot erase <nome>"

Parametri
device ITestDevice : il ITestDevice su cui operare

partition String : il nome della partizione da cancellare

Lancia
DeviceNotAvailableException
TargetSetupError