IDeviceFlasher

public interface IDeviceFlasher

com.android.tradefed.targetprep.IDeviceFlasher

Bekannte indirekte Unterklassen CdmaDeviceFlasher, FastbootDeviceFlasher, OtaUpdateDeviceFlasher, SystemUpdaterDeviceFlasher CdmaDeviceFlasher Eine Klasse, die ein Bild auf einem physischen Android-Gerät mit einer CDMA-Funkschnittstelle flasht.  FastbootDeviceFlasher Eine Klasse, die auf „fastboot“ basiert, um ein Image auf physische Android-Hardware zu flashen.  OtaUpdateDeviceFlasher Ein Gerät, das das Skript „system/update_engine/scripts/update_device.py“ mit einem vollständigen oder inkrementellen OTA-Paket auslöst, um das Geräte-Image zu aktualisieren.  SystemUpdaterDeviceFlasher Ein IDeviceFlasher, das auf den System Updater angewiesen ist, um ein System-Image zu installieren, das in einem OTA-Updatepaket enthalten ist.

---

Flasht ein Geräte-Image auf ein Gerät.

Zusammenfassung

Öffentliche Methoden
default boolean	checkAntiRollback(ITestDevice device, IDeviceBuildInfo deviceBuild) Prüfen Sie, ob ein Anti-Rollback ausgelöst wurde.
abstract void	flash(ITestDevice device, IDeviceBuildInfo deviceBuild) Flashes werden auf dem Gerät erstellt.
default Set<String>	getAdditionalFileFilters() Filter für zusätzliche Build-Artefakte abrufen
abstract CommandStatus	getSystemFlashingStatus() Rufen Sie den Status der Befehlsausführung für das Flashen primärer Systempartitionen ab.
abstract IDeviceFlasher.UserDataFlashOption	getUserDataFlashOption() Ruft ab, ob das Nutzerdatenträger-Image geflasht, gelöscht oder beibehalten werden soll.
abstract void	overrideDeviceOptions(ITestDevice device) Überschreibt Optionen für ein Gerät.
default void	postFlashOperations(ITestDevice device, IDeviceBuildInfo deviceBuild) Alle Bereinigungs- und Prüfvorgänge, die nach dem eigentlichen Flashen des kritischen Abschnitts erfolgen müssen.
default void	preFlashOperations(ITestDevice device, IDeviceBuildInfo deviceBuild) Alle Einrichtungsvorgänge und ‑prüfungen, die vor dem eigentlichen Flashen des kritischen Abschnitts erfolgen müssen.
abstract void	setDataWipeSkipList(Collection<String> dataWipeSkipList) Legt die Liste der Pfade unter /data fest, die beim Verwenden von ITestsZipInstaller nicht gelöscht werden sollen. Die Granularität der Überspringen-Liste bezieht sich auf die direkten untergeordneten Elemente von /data.
default void	setExtraMetadata(Map<String, String> metadata) Ermöglicht dem Flasher, zusätzliche Metadatenoptionen zu empfangen.
abstract void	setFlashingResourcesRetriever(IFlashingResourcesRetriever retriever) Legt den Mechanismus fest, mit dem der Flasher Ressourcendateien für das Flashen abrufen kann.
abstract void	setForceSystemFlash(boolean forceSystemFlash) Legt fest, ob das System immer geflasht werden soll, auch wenn die aktuelle Version ausgeführt wird.
default void	setRamdiskPartition(String ramdiskPartition) Legt die Ramdisk-Partition fest.
default void	setShouldFlashRamdisk(boolean shouldFlashRamdisk) Legt fest, ob nach dem Aktualisieren des Geräts über eine ZIP-Datei mit einem Image eine zusätzliche Ramdisk geflasht werden soll.
abstract void	setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption) Legt fest, ob das Nutzerdatenträger-Image geflasht, gelöscht oder beibehalten werden soll.
abstract void	setWipeTimeout(long timeout) Legen Sie das Zeitlimit für das Löschen der Daten fest.
default boolean	shouldFlashRamdisk() Prüft, ob der Flasher so eingestellt ist, dass nach dem Aktualisieren des Geräts über eine Image-ZIP-Datei eine zusätzliche RAM-Disk geflasht werden soll.
default boolean	supportsFlashingInFastbootD() Gibt an, ob das Gerät, auf dem der Flasher ausgeführt wird, im fastbootd-Modus geflasht werden kann.
default void	tearDownFlasher() Letzte Möglichkeit für die Flasher-Implementierung, um sich selbst zu bereinigen

Öffentliche Methoden

checkAntiRollback

public boolean checkAntiRollback (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Prüfen Sie, ob ein Anti-Rollback ausgelöst wurde.

Parameter
device	ITestDevice
deviceBuild	IDeviceBuildInfo

Gibt Folgendes zurück:
boolean

Löst aus
DeviceNotAvailableException

flashen

public abstract void flash (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Flashes werden auf dem Gerät erstellt.

Die Funktion wird sofort nach Abschluss des Flash-Vorgangs zurückgegeben. Anrufer sollten warten, bis das Gerät online und verfügbar ist, bevor sie mit dem Testen fortfahren.

Parameter
device	ITestDevice: der zu flash-ende ITestDevice
deviceBuild	IDeviceBuildInfo: der zu flash-ende IDeviceBuildInfo

Löst aus
DeviceNotAvailableException	Wenn das Gerät nicht mehr reagiert
TargetSetupError	Fehler beim Flashen des Builds

getAdditionalFileFilters

public Set<String> getAdditionalFileFilters ()

Filter für zusätzliche Build-Artefakte abrufen

Einige Flasher benötigen bestimmte Build-Artefakte, die nicht zu den standardmäßig verwendeten gehören. Solche Flasher sollten diese Methode überschreiben, damit jeder Nutzer der Flashing-Tools nicht über diese Dateien Bescheid wissen und Befehlszeilenoptionen angeben muss.

Diese Methode wird für eine temporäre Instanz von IDeviceFlasher aufgerufen. Es sollte also kein Status verwendet werden, der über den im Standardkonstruktor bereitgestellten Status hinausgeht.

Strings im Set werden als Dateimuster interpretiert und alle Dateien, die dem Muster entsprechen, werden abgerufen.

Standardmäßig gibt diese Methode ein leeres Set zurück.

Gibt Folgendes zurück:
Set<String>

getSystemFlashingStatus

public abstract CommandStatus getSystemFlashingStatus ()

Rufen Sie den Status der Befehlsausführung für das Flashen primärer Systempartitionen ab.

Wenn Systempartitionen nicht geflasht werden (das System hat bereits den zu flashhenden Build), kann der Befehlsstatus null sein.

Gibt Folgendes zurück:
CommandStatus

getUserDataFlashOption

public abstract IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

Ruft ab, ob das Nutzerdatenträger-Image geflasht, gelöscht oder beibehalten werden soll.

Gibt Folgendes zurück:
IDeviceFlasher.UserDataFlashOption	Ob das Nutzerdaten-Image geflasht, gelöscht oder beibehalten werden soll

overrideDeviceOptions

public abstract void overrideDeviceOptions (ITestDevice device)

Überschreibt Optionen für ein Gerät. Wird verwendet, um Standardoptionswerte zu überschreiben, wenn die Standardwerte von einem bestimmten Gerät nicht unterstützt werden.

postFlashOperations

public void postFlashOperations (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Alle Bereinigungs- und Prüfvorgänge, die nach dem eigentlichen Flashen des kritischen Abschnitts erfolgen müssen. Keiner dieser Vorgänge wird in den kritischen Abschnitt mit Parallelitätssteuerung aufgenommen.

Parameter
device	ITestDevice: der zu flash-ende ITestDevice
deviceBuild	IDeviceBuildInfo: der zu flash-ende IDeviceBuildInfo

Löst aus
DeviceNotAvailableException	Wenn das Gerät nicht mehr reagiert
TargetSetupError	wenn ein Setup fehlschlägt

preFlashOperations

public void preFlashOperations (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Alle Einrichtungsvorgänge und ‑prüfungen, die vor dem eigentlichen Flashen des kritischen Abschnitts erfolgen müssen. Keiner dieser Vorgänge wird in den kritischen Abschnitt mit Parallelitätssteuerung aufgenommen.

Parameter
device	ITestDevice: der zu flash-ende ITestDevice
deviceBuild	IDeviceBuildInfo: der zu flash-ende IDeviceBuildInfo

Löst aus
DeviceNotAvailableException	Wenn das Gerät nicht mehr reagiert
TargetSetupError	wenn ein Setup fehlschlägt

setDataWipeSkipList

public abstract void setDataWipeSkipList (Collection<String> dataWipeSkipList)

Legt die Liste der Pfade unter /data fest, die beim Verwenden von ITestsZipInstaller nicht gelöscht werden sollen.

Die Granularität der Überspringen-Liste bezieht sich auf die direkten untergeordneten Elemente von /data.

Parameter
dataWipeSkipList	Collection

setExtraMetadata

public void setExtraMetadata (Map<String, String> metadata)

Ermöglicht dem Flasher, zusätzliche Metadatenoptionen zu empfangen.

Parameter
metadata	Map

setFlashingResourcesRetriever

public abstract void setFlashingResourcesRetriever (IFlashingResourcesRetriever retriever)

Legt den Mechanismus fest, mit dem der Flasher Ressourcendateien für das Flashen abrufen kann.

Parameter
retriever	IFlashingResourcesRetriever: die zu verwendende IFlashingResourcesRetriever

setForceSystemFlash

public abstract void setForceSystemFlash (boolean forceSystemFlash)

Legt fest, ob das System immer geflasht werden soll, auch wenn die aktuelle Version ausgeführt wird.

setRamdiskPartition

public void setRamdiskPartition (String ramdiskPartition)

Legt die Ramdisk-Partition fest.

setShouldFlashRamdisk

public void setShouldFlashRamdisk (boolean shouldFlashRamdisk)

Legt fest, ob nach dem Aktualisieren des Geräts über eine ZIP-Datei mit einem Image eine zusätzliche Ramdisk geflasht werden soll.

setUserDataFlashOption

public abstract void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

Legt fest, ob das Nutzerdatenträger-Image geflasht, gelöscht oder beibehalten werden soll.

setWipeTimeout

public abstract void setWipeTimeout (long timeout)

Legen Sie das Zeitlimit für das Löschen der Daten fest.

Parameter
timeout	long

shouldFlashRamdisk

public boolean shouldFlashRamdisk ()

Prüft, ob der Flasher so eingestellt ist, dass nach dem Aktualisieren des Geräts über eine Image-ZIP-Datei eine zusätzliche RAM-Disk geflasht werden soll.

Gibt Folgendes zurück:
boolean

supportsFlashingInFastbootD

public boolean supportsFlashingInFastbootD ()

Gibt an, ob das Gerät, auf dem der Flasher ausgeführt wird, im fastbootd-Modus geflasht werden kann.

Gibt Folgendes zurück:
boolean

tearDownFlasher

public void tearDownFlasher ()

Letzte Möglichkeit für die Flasher-Implementierung, um nach sich selbst aufzuräumen