A partire dal 27 marzo 2025, ti consigliamo di utilizzare android-latest-release anziché aosp-main per compilare e contribuire ad AOSP. Per ulteriori informazioni, vedi Modifiche ad AOSP.

Questa pagina è stata tradotta dall'API Cloud Translation.

IDeviceFlasher

public interface IDeviceFlasher

com.android.tradefed.targetprep.IDeviceFlasher

Sottoclassi indirette note

CdmaDeviceFlasher, FastbootDeviceFlasher, OtaUpdateDeviceFlasher, SystemUpdaterDeviceFlasher

CdmaDeviceFlasher	Una classe che mostra un'immagine su un dispositivo Android fisico con una radio CDMA.
FastbootDeviceFlasher	Una classe che si basa su fastboot per flashare un'immagine su hardware Android fisico.
OtaUpdateDeviceFlasher	Un programma di flashing del dispositivo che attiva lo script system/update_engine/scripts/update_device.py con un pacchetto OTA completo o incrementale per aggiornare l'immagine del dispositivo.
SystemUpdaterDeviceFlasher	Un `IDeviceFlasher` che si basa sul programma di aggiornamento del sistema per installare un'immagine di sistema inclusa in un pacchetto di aggiornamento OTA.

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

Riepilogo

Metodi pubblici
`abstract void`	`flash(ITestDevice device, IDeviceBuildInfo deviceBuild)` I flash vengono creati sul dispositivo.
`default`	`getAdditionalFileFilters()` Ottieni filtri per artefatti build aggiuntivi.
`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 cancellata, pulita o conservata
`abstract void`	`overrideDeviceOptions(ITestDevice device)` Ignorare 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 il flashing effettivo della sezione critica.
`default void`	`preFlashOperations(ITestDevice device, IDeviceBuildInfo deviceBuild)` Tutte le operazioni e i controlli di configurazione che devono essere eseguiti prima della sezione critica di flashing effettiva.
`abstract void`	`setDataWipeSkipList( dataWipeSkipList)` Imposta l'elenco dei percorsi in `/data` da evitare di cancellare quando utilizzi `ITestsZipInstaller` Tieni presente che la granularità dell'elenco di ignorati è costituita dagli elementi secondari diretti di `/data`.
`default void`	`setExtraMetadata( metadata)` Consente al flasher di ricevere opzioni di metadati aggiuntive.
`abstract void`	`setFlashingResourcesRetriever(IFlashingResourcesRetriever retriever)` Imposta il meccanismo mediante il quale il flasher può recuperare i file delle risorse per il flashing.
`abstract void`	`setForceSystemFlash(boolean forceSystemFlash)` Imposta se il sistema deve sempre essere flashato anche se è in esecuzione la build corrente
`default void`	`setRamdiskPartition(String ramdiskPartition)` Imposta la partizione ramdisk
`default void`	`setShouldFlashRamdisk(boolean shouldFlashRamdisk)` Imposta se deve essere flashato un ramdisk aggiuntivo dopo l'aggiornamento del dispositivo tramite il file zip dell'immagine
`abstract void`	`setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption)` Attiva/disattiva l'opzione che indica se l'immagine dei dati utente deve essere flashata, cancellata o conservata
`abstract void`	`setWipeTimeout(long timeout)` Imposta il timeout per la cancellazione dei dati.
`default boolean`	`shouldFlashRamdisk()` Verifica se il flasher è impostato per avere un ramdisk aggiuntivo da flashare dopo l'aggiornamento del dispositivo tramite zip dell'immagine
`default boolean`	`supportsFlashingInFastbootD()` Indica se il dispositivo che implementa il flasher può essere flashato in modalità fastbootd.
`default void`	`tearDownFlasher()` Ultima opportunità per l'implementazione del flasher di eseguire la pulizia automatica

Metodi pubblici

flash

public abstract void flash (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

I flash vengono creati sul dispositivo.

Restituisce immediatamente dopo il completamento del flashing. Chi chiama deve 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`	se l'installazione della build non è riuscita
`DeviceNotAvailableException`	se il dispositivo non risponde

getAdditionalFileFilters

public  getAdditionalFileFilters ()

Ottieni filtri per artefatti build aggiuntivi.

Alcuni flasher richiedono determinati artefatti di build che non rientrano tra quelli predefiniti utilizzati. Questi flasher devono ignorare questo metodo, in modo che ogni utente degli strumenti di flashing non debba conoscere questi file e fornire opzioni della riga di comando.

Tieni presente che questo metodo viene richiamato su un'istanza temporanea di IDeviceFlasher, quindi non è possibile fare affidamento su uno stato diverso da quello fornito nel costruttore predefinito.

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

Per impostazione predefinita, questo metodo restituisce un insieme 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 cancellata, pulita o conservata

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

overrideDeviceOptions

public abstract void overrideDeviceOptions (ITestDevice device)

Ignorare le opzioni per un dispositivo. Utilizzato per ignorare 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 il flashing effettivo della sezione critica. 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 una 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 di flashing effettiva. 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 una configurazione non va a buon fine
`DeviceNotAvailableException`	se il dispositivo non risponde

setDataWipeSkipList

public abstract void setDataWipeSkipList ( dataWipeSkipList)

Imposta l'elenco dei percorsi in /data da evitare di cancellare quando utilizzi ITestsZipInstaller

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

Parametri
`dataWipeSkipList`

setExtraMetadata

public void setExtraMetadata ( metadata)

Consente al flasher di ricevere opzioni di metadati aggiuntive.

Parametri
`metadata`

setFlashingResourcesRetriever

public abstract void setFlashingResourcesRetriever (IFlashingResourcesRetriever retriever)

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

Parametri
`retriever`	`IFlashingResourcesRetriever`: il `IFlashingResourcesRetriever` da utilizzare

setForceSystemFlash

public abstract void setForceSystemFlash (boolean forceSystemFlash)

Imposta se il sistema deve sempre essere flashato 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 flashato un ramdisk aggiuntivo dopo l'aggiornamento del dispositivo tramite il file zip dell'immagine

setUserDataFlashOption

public abstract void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

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

setWipeTimeout

public abstract void setWipeTimeout (long timeout)

Imposta il timeout per la cancellazione dei dati.

Parametri
`timeout`	`long`

shouldFlashRamdisk

public boolean shouldFlashRamdisk ()

Verifica se il flasher è impostato per avere un ramdisk aggiuntivo da flashare dopo l'aggiornamento del dispositivo tramite zip dell'immagine

Ritorni
`boolean`

supportsFlashingInFastbootD

public boolean supportsFlashingInFastbootD ()

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

Ritorni
`boolean`

tearDownFlasher

public void tearDownFlasher ()

Ultima opportunità per l'implementazione del flasher di eseguire la pulizia automatica