Ab 2026 werden wir, um unser stabiles Entwicklungsmodell für den Trunk zu unterstützen und die Plattformstabilität für das Ökosystem zu gewährleisten, den Quellcode im 2. und 4. Quartal in AOSP veröffentlichen. Verwenden Sie android-latest-release, um AOSP zu entwickeln und dazu beizutragen. Der Manifestzweig android-latest-release verweist immer auf das neueste Release, das an AOSP übertragen wurde. Weitere Informationen finden Sie unter Änderungen an AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

SystemUpdaterDeviceFlasher

public class SystemUpdaterDeviceFlasher
extends Object implements IDeviceFlasher

java.lang.Object
↳	com.android.tradefed.targetprep.SystemUpdaterDeviceFlasher

Ein IDeviceFlasher der den Systemupdater verwendet, um ein Systemimage zu installieren, das in einem OTA-Updatepaket enthalten ist. Diese Implementierung verwendet insbesondere nicht Fastboot.

Zusammenfassung

Öffentliche Konstruktoren
`SystemUpdaterDeviceFlasher()`

Öffentliche Methoden
`void`	`flash(ITestDevice device, IDeviceBuildInfo deviceBuild)` Flasht den Build auf dem Gerät. Bei dieser Implementierung wird davon ausgegangen, dass die vom `IDeviceBuildInfo.getDeviceImageFile()` zurückgegebene Geräteimage-Datei eine OTA-Update-ZIP-Datei ist.
`CommandStatus`	`getSystemFlashingStatus()` Ruft den Befehlsausführungsstatus für das Flashen primärer Systempartitionen ab.
`IDeviceFlasher.UserDataFlashOption`	`getUserDataFlashOption()` Gibt an, ob das Nutzerdatenimage geflasht, gelöscht oder beibehalten werden soll.
`void`	`overrideDeviceOptions(ITestDevice device)` Überschreibt Optionen für ein Gerät.
`void`	`setDataWipeSkipList(Collection<String> dataWipeSkipList)` Legt die Liste der Pfade unter `/data` fest, die bei Verwendung von `ITestsZipInstaller` nicht gelöscht werden sollen. Die Granularität der Überspringliste sind die direkten untergeordneten Elemente von `/data`.
`void`	`setFlashingResourcesRetriever(IFlashingResourcesRetriever retriever)` Legt den Mechanismus fest, mit dem der Flasher Ressourcendateien zum Flashen abrufen kann.
`void`	`setForceSystemFlash(boolean forceSystemFlash)` Legt fest, ob das System immer geflasht werden soll, auch wenn der aktuelle Build ausgeführt wird.
`void`	`setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption)` Legt fest, ob das Nutzerdatenimage geflasht, gelöscht oder beibehalten werden soll. Diese Implementierung unterstützt nur `IDeviceFlasher.UserDataFlashOption.TESTS_ZIP` und `IDeviceFlasher.UserDataFlashOption.RETAIN` als gültige Optionen.
`void`	`setWipeTimeout(long timeout)` Legt das Zeitlimit für das Löschen der Daten fest.

Öffentliche Konstruktoren

SystemUpdaterDeviceFlasher

public SystemUpdaterDeviceFlasher ()

Öffentliche Methoden

flash

public void flash (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Flasht den Build auf dem Gerät.

Gibt sofort zurück, nachdem das Flashen abgeschlossen ist. Aufrufer sollten warten, bis das Gerät online und verfügbar ist, bevor sie mit dem Testen fortfahren.

Bei dieser Implementierung wird davon ausgegangen, dass die vom IDeviceBuildInfo.getDeviceImageFile() zurückgegebene Geräteimage-Datei eine OTA-Update-ZIP-Datei ist. Es ist nicht sicher, diesen Updater in einem Kontext zu verwenden, in dem diese Annahme nicht zutrifft.

Parameter
`device`	`ITestDevice`: das zu flashende `ITestDevice`
`deviceBuild`	`IDeviceBuildInfo`: das zu flashende `IDeviceBuildInfo`

Löst aus
	com.android.tradefed.device.DeviceNotAvailableException
	com.android.tradefed.targetprep.TargetSetupError
`DeviceNotAvailableException`
`TargetSetupError`

getSystemFlashingStatus

public CommandStatus getSystemFlashingStatus ()

Ruft den Befehlsausführungsstatus für das Flashen primärer Systempartitionen ab.

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

Gibt Folgendes zurück:
`CommandStatus`

getUserDataFlashOption

public IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

Gibt an, ob das Nutzerdatenimage geflasht, gelöscht oder beibehalten werden soll.

Gibt Folgendes zurück:
`IDeviceFlasher.UserDataFlashOption`	Gibt an, ob das Nutzerdatenimage geflasht, gelöscht oder beibehalten werden soll.

overrideDeviceOptions

public void overrideDeviceOptions (ITestDevice device)

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

setDataWipeSkipList

public void setDataWipeSkipList (Collection<String> dataWipeSkipList)

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

Die Granularität der Überspringliste sind die direkten untergeordneten Elemente von /data.

Parameter
`dataWipeSkipList`	`Collection`

setFlashingResourcesRetriever

public void setFlashingResourcesRetriever (IFlashingResourcesRetriever retriever)

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

Parameter
`retriever`	`IFlashingResourcesRetriever`: das zu verwendende `IFlashingResourcesRetriever`

setForceSystemFlash

public void setForceSystemFlash (boolean forceSystemFlash)

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

setUserDataFlashOption

public void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

Legt fest, ob das Nutzerdatenimage geflasht, gelöscht oder beibehalten werden soll.

Diese Implementierung unterstützt nur IDeviceFlasher.UserDataFlashOption.TESTS_ZIP und IDeviceFlasher.UserDataFlashOption.RETAIN als gültige Optionen.

setWipeTimeout

public void setWipeTimeout (long timeout)

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

Parameter
`timeout`	`long`