Ab dem 27. März 2025 empfehlen wir, android-latest-release anstelle von aosp-main zu verwenden, um AOSP zu erstellen und Beiträge dazu zu leisten. Weitere Informationen finden Sie unter Änderungen am AOSP.

Diese Seite wurde von der Cloud Translation API übersetzt.

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 einem CDMA-Funkgerät einblendet.
FastbootDeviceFlasher	Eine Klasse, die auf „fastboot“ angewiesen ist, um ein Image auf physische Android-Hardware zu flashen.
OtaUpdateDeviceFlasher	Ein Tool zum Flashen von Geräten, 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 Systemimage zu installieren, das in einem OTA-Updatepaket enthalten ist.

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

Zusammenfassung

Öffentliche Methoden
`abstract void`	`flash(ITestDevice device, IDeviceBuildInfo deviceBuild)` Flashes werden auf dem Gerät erstellt.
`default`	`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( dataWipeSkipList)` Legt die Liste der Pfade unter `/data` fest, die beim Verwenden von `ITestsZipInstaller` nicht gelöscht werden sollen. Die Granularität der Überspringliste entspricht den direkten untergeordneten Elementen von `/data`.
`default void`	`setExtraMetadata( metadata)` Ermöglicht dem Flasher, zusätzliche Metadatenoptionen zu empfangen.
`abstract void`	`setFlashingResourcesRetriever(IFlashingResourcesRetriever retriever)` Legt den Mechanismus fest, über den 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 ein Image-ZIP-Archiv 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 aufzuräumen

Öffentliche Methoden

Flash

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`: das zu flash-ende `ITestDevice`
`deviceBuild`	`IDeviceBuildInfo`: das zu flash-ende `IDeviceBuildInfo`

Ausgabe
`TargetSetupError`	Fehler beim Flashen des Builds
`DeviceNotAvailableException`	Wenn das Gerät nicht mehr reagiert

getAdditionalFileFilters

public  getAdditionalFileFilters ()

Filter für zusätzliche Build-Artefakte abrufen

Für einige Flasher sind bestimmte Build-Artefakte erforderlich, 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 informiert sein 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.

Returns

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.

Returns
`CommandStatus`

getUserDataFlashOption

public abstract IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

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

Returns
`IDeviceFlasher.UserDataFlashOption`	Ob das Nutzerdatenset 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`: das zu flash-ende `ITestDevice`
`deviceBuild`	`IDeviceBuildInfo`: das zu flash-ende `IDeviceBuildInfo`

Ausgabe
`TargetSetupError`	Wenn ein Setup 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 erfolgen müssen. Keiner dieser Vorgänge wird in den kritischen Abschnitt mit Parallelitätssteuerung aufgenommen.

Parameter
`device`	`ITestDevice`: das zu flash-ende `ITestDevice`
`deviceBuild`	`IDeviceBuildInfo`: das zu flash-ende `IDeviceBuildInfo`

Ausgabe
`TargetSetupError`	Wenn ein Setup fehlschlägt
`DeviceNotAvailableException`	Wenn das Gerät nicht mehr reagiert

setDataWipeSkipList

public abstract void setDataWipeSkipList ( dataWipeSkipList)

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

Die Granularität der Überspringliste entspricht den direkten untergeordneten Elementen von /data.

Parameter
`dataWipeSkipList`

setExtraMetadata

public void setExtraMetadata ( metadata)

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

Parameter
`metadata`

setFlashingResourcesRetriever

public abstract void setFlashingResourcesRetriever (IFlashingResourcesRetriever retriever)

Legt den Mechanismus fest, über den 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.

Returns
`boolean`

supportsFlashingInFastbootD

public boolean supportsFlashingInFastbootD ()

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

Returns
`boolean`

tearDownFlasher

public void tearDownFlasher ()

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