IDeviceFlasher

public interface IDeviceFlasher

com.android.tradefed.targetprep.IDeviceFlasher


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

Zusammenfassung

Öffentliche Methoden

abstract void flash(ITestDevice device, IDeviceBuildInfo deviceBuild)

Blinken wird auf dem Gerät erstellt.

default getAdditionalFileFilters()

Filter für zusätzliche Build-Artefakte abrufen

abstract CommandStatus getSystemFlashingStatus()

Ruft den Status der Befehlsausführung für das Flashen der primären Systempartitionen ab.

abstract IDeviceFlasher.UserDataFlashOption getUserDataFlashOption()

Gibt an, ob das Image mit den Nutzerdaten geflasht, gelöscht oder beibehalten werden soll

abstract void overrideDeviceOptions(ITestDevice device)

Optionen für ein Gerät überschreiben

default void postFlashOperations(ITestDevice device, IDeviceBuildInfo deviceBuild)

Alle Bereinigungsvorgänge und Prüfungen, die nach dem eigentlichen Flashen des kritischen Abschnitts ausgeführt werden müssen.

default void preFlashOperations(ITestDevice device, IDeviceBuildInfo deviceBuild)

Alle Einrichtungsvorgänge und ‑prüfungen, die vor dem eigentlichen Flashen des kritischen Abschnitts ausgeführt werden müssen.

abstract void setDataWipeSkipList( dataWipeSkipList)

Damit wird verhindert, dass die Liste der Pfade unter /data gelöscht wird, wenn ITestsZipInstaller verwendet wird.

Die Granularität der Auslöseliste entspricht den direkt untergeordneten Elementen von /data.

abstract void setFlashingResourcesRetriever(IFlashingResourcesRetriever retriever)

Legt den Mechanismus fest, mit dem der Flasher Ressourcendateien zum Flashen abrufen kann.

abstract void setForceSystemFlash(boolean forceSystemFlash)

Legen Sie fest, ob das System immer geflasht werden soll, auch wenn der aktuelle Build ausgeführt wird.

default void setRamdiskPartition(String ramdiskPartition)

Ramdisk-Partition festlegen

default void setShouldFlashRamdisk(boolean shouldFlashRamdisk)

Gibt an, ob nach dem Aktualisieren des Geräts über ein Image-Zip-Archiv ein zusätzliches RAM-Disk geflasht werden soll.

abstract void setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption)

Legt fest, ob das Image mit den Nutzerdaten 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 ein Image-Zip-Archiv ein zusätzliches RAM-Disk geflasht werden soll

default boolean supportsFlashingInFastbootD()

Gibt an, ob das Gerät, auf dem der Flasher implementiert ist, im Fastbootd-Modus geflasht werden kann.

default void tearDownFlasher()

Letzte Möglichkeit für die Implementierung des Flashers, nach dem Flashen aufzuräumen

Öffentliche Methoden

Flash

public abstract void flash (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Blinken wird auf dem Gerät erstellt.

Wird sofort nach Abschluss des Flashens zurückgegeben. Anrufer sollten warten, bis das Gerät online und verfügbar ist, bevor sie mit dem Testen fortfahren.

Parameter
device ITestDevice: die ITestDevice, die geflasht werden soll

deviceBuild IDeviceBuildInfo: die IDeviceBuildInfo, die geflasht werden soll

Ausgabe
TargetSetupError if failed to flash build
DeviceNotAvailableException Wenn das Gerät nicht mehr reagiert

getAdditionalFileFilters

public  getAdditionalFileFilters ()

Filter für zusätzliche Build-Artefakte abrufen

Einige Flasher benötigen bestimmte Build-Artefakte, die nicht zu den Standard-Artefakten gehören. Solche Tools sollten diese Methode überschreiben, damit nicht jeder Nutzer der Tools diese Dateien kennen und Befehlszeilenoptionen angeben muss.

Diese Methode wird auf einer temporären Instanz des IDeviceFlashers aufgerufen. Daher sollte kein Status verwendet werden, der über den im Standardkonstruktor bereitgestellten 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.

Returns

getSystemFlashingStatus

public abstract CommandStatus getSystemFlashingStatus ()

Ruft den Status der Befehlsausführung für das Flashen der primären Systempartitionen ab.

Hinweis: Wenn keine Systempartitionen geflasht werden (das System hat bereits die zu flashende Build-Version), kann der Befehlsstatus null sein.

Returns
CommandStatus

getUserDataFlashOption

public abstract IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

Gibt an, ob das Image mit den Nutzerdaten geflasht, gelöscht oder beibehalten werden soll

Returns
IDeviceFlasher.UserDataFlashOption Ob das Image mit den Nutzerdaten geflasht, gelöscht oder beibehalten werden soll

overrideDeviceOptions

public abstract void overrideDeviceOptions (ITestDevice device)

Optionen für ein Gerät überschreiben 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 Bereinigungsvorgänge und Prüfungen, die nach dem eigentlichen Flashen des kritischen Abschnitts ausgeführt werden müssen. Keine dieser Vorgänge wird in den synchron gesteuerten kritischen Abschnitt aufgenommen.

Parameter
device ITestDevice: die ITestDevice, die geflasht werden soll

deviceBuild IDeviceBuildInfo: die IDeviceBuildInfo, die geflasht werden soll

Ausgabe
TargetSetupError Wenn die Einrichtung fehlschlägt
DeviceNotAvailableException Wenn das Gerät nicht mehr reagiert

preFlashOperations

public void preFlashOperations (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Alle Einrichtungsvorgänge und ‑prüfungen, die vor dem eigentlichen Flashen des kritischen Abschnitts ausgeführt werden müssen. Keine dieser Vorgänge wird in den synchron gesteuerten kritischen Abschnitt aufgenommen.

Parameter
device ITestDevice: die ITestDevice, die geflasht werden soll

deviceBuild IDeviceBuildInfo: die IDeviceBuildInfo, die geflasht werden soll

Ausgabe
TargetSetupError Wenn die Einrichtung fehlschlägt
DeviceNotAvailableException Wenn das Gerät nicht mehr reagiert

setDataWipeSkipList

public abstract void setDataWipeSkipList ( dataWipeSkipList)

Damit wird verhindert, dass die Liste der Pfade unter /data gelöscht wird, wenn ITestsZipInstaller verwendet wird.

Die Granularität der Auslöseliste entspricht den direkten untergeordneten Elementen von /data.

Parameter
dataWipeSkipList

setFlashingResourcesRetriever

public abstract void setFlashingResourcesRetriever (IFlashingResourcesRetriever retriever)

Legt den Mechanismus fest, mit dem der Flasher Ressourcendateien zum Flashen abrufen kann.

Parameter
retriever IFlashingResourcesRetriever: der zu verwendende IFlashingResourcesRetriever

setForceSystemFlash

public abstract void setForceSystemFlash (boolean forceSystemFlash)

Legen Sie fest, ob das System immer geflasht werden soll, auch wenn der aktuelle Build ausgeführt wird.

setRamdiskPartition

public void setRamdiskPartition (String ramdiskPartition)

Ramdisk-Partition festlegen

setShouldFlashRamdisk

public void setShouldFlashRamdisk (boolean shouldFlashRamdisk)

Gibt an, ob nach dem Aktualisieren des Geräts über ein Image-Zip-Archiv ein zusätzliches RAM-Disk geflasht werden soll.

setUserDataFlashOption

public abstract void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

Legt fest, ob das Image mit den Nutzerdaten 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 ein Image-Zip-Archiv ein zusätzliches RAM-Disk geflasht werden soll

Returns
boolean

supportsFlashingInFastbootD

public boolean supportsFlashingInFastbootD ()

Gibt an, ob das Gerät, auf dem der Flasher implementiert ist, im Fastbootd-Modus geflasht werden kann.

Returns
boolean

tearDownFlasher

public void tearDownFlasher ()

Letzte Möglichkeit für die Implementierung des Flashers, nach dem Flashen aufzuräumen