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.

DeviceFlashPreparer

public abstract class DeviceFlashPreparer
extends BaseTargetPreparer implements IConfigurationReceiver, ITestLoggerReceiver

java.lang.Object
↳	com.android.tradefed.targetprep.BaseTargetPreparer
	↳	com.android.tradefed.targetprep.DeviceFlashPreparer

Bekannte direkte Unterklassen

FastbootUpdateBootstrapPreparer, GoogleDeviceFlashPreparer

FastbootUpdateBootstrapPreparer	Ein `ITargetPreparer`, das bestimmte Dateien (Bootloader, Funkschnittstelle, Geräte-Image-ZIP) in `IDeviceBuildInfo` bereitstellt, damit Geräte mit `FastbootDeviceFlasher` geflasht werden können. Anschließend werden Geräteattribute nach dem Booten in die Build-Informationen eingefügt, um Ergebnisse zu melden.
GoogleDeviceFlashPreparer	Eine Spezialisierung von `DeviceFlashPreparer`, die benutzerdefinierte Schritte unterstützt, die zum Flashen von Google-Geräten erforderlich sind.

Ein ITargetPreparer, das ein Bild auf physischer Android-Hardware anzeigt.

Zusammenfassung

Öffentliche Konstruktoren
`DeviceFlashPreparer()`

Öffentliche Methoden
`void`	`addAllowedBranchForTransitionInIncremental(String branch)`
`void`	`addBranchTransitionInIncremental(String origin, String destination)`
`void`	`addFlasherExtraMetadata(Map<String, String> metadata)`
`IBuildInfo`	`getBuild(TestInformation testInfo)` Umschließe „getBuildInfo“, damit wir die Funktion für bestimmte Szenarien überschreiben können.
`ITestLogger`	`getTestLogger()`
`boolean`	`isIncrementalFlashingEnabled()`
`boolean`	`isIncrementalFlashingForceDisabled()`
`void`	`setAllowCrossReleaseFlashing(boolean allowCrossReleaseFlashing)`
`void`	`setAllowUnzipBaseline(boolean allowUnzipBaseline)`
`void`	`setApplySnapshot(boolean applySnapshot)`
`void`	`setConfiguration(IConfiguration configuration)` Fügt die verwendete `IConfiguration` ein.
`void`	`setIgnoreHostOptions(boolean ignoreHostOptions)`
`void`	`setTestLogger(ITestLogger testLogger)` Fügt die `ITestLogger`-Instanz ein.
`void`	`setUp(TestInformation testInfo)`
`void`	`setUpdateBootloaderFromUserspace(boolean updateBootloaderFromUserspace)`
`void`	`setUseIncrementalNewFlow(boolean useIncrementalNewFlow)`
`void`	`setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption)` Option „userdata-flash“ festlegen
`void`	`setWipeAfterApplySnapshot(boolean wipeAfterApplySnapshot)`
`void`	`tearDown(TestInformation testInfo, Throwable e)`
`void`	`useMerkleTreeComparison(boolean enableMerkleTreeComparison)`

Geschützte Methoden
`void`	`checkDeviceProductType(ITestDevice device, IDeviceBuildInfo deviceBuild)` Mögliche Prüfung vor dem Flashen, um sicherzustellen, dass das Gerät den Build-Informationen entspricht.
`abstract IDeviceFlasher`	`createFlasher(ITestDevice device)` Erstellen Sie `IDeviceFlasher` zur Verwendung.
`long`	`getDeviceBootWaitTime()` Ruft die Wartezeit für den Gerätestart ab
`IHostOptions`	`getHostOptions()` Ruft die zu verwendende `IHostOptions`-Instanz ab.
`void`	`reportFlashMetrics(String branch, String buildFlavor, String buildId, String serial, long queueTime, long flashingTime, CommandStatus flashingStatus)` Meldet Daten zum Timing des Geräte-Flashings an das Messwert-Backend
`void`	`setSkipPostFlashBuildIdCheck(boolean skipPostFlashBuildIdCheck)`
`void`	`setUseIncrementalFlashing(boolean incrementalFlashing)`

Öffentliche Konstruktoren

DeviceFlashPreparer

public DeviceFlashPreparer ()

Öffentliche Methoden

addAllowedBranchForTransitionInIncremental

public void addAllowedBranchForTransitionInIncremental (String branch)

Parameter
`branch`	`String`

addBranchTransitionInIncremental

public void addBranchTransitionInIncremental (String origin, 
                String destination)

Parameter
`origin`	`String`
`destination`	`String`

addFlasherExtraMetadata

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

Parameter
`metadata`	`Map`

getBuild

public IBuildInfo getBuild (TestInformation testInfo)

Umschließe „getBuildInfo“, damit wir die Funktion für bestimmte Szenarien überschreiben können.

Parameter
`testInfo`	`TestInformation`

Gibt Folgendes zurück:
`IBuildInfo`

getTestLogger

public ITestLogger getTestLogger ()

Gibt Folgendes zurück:
`ITestLogger`

isIncrementalFlashingEnabled

public boolean isIncrementalFlashingEnabled ()

Gibt Folgendes zurück:
`boolean`

isIncrementalFlashingForceDisabled

public boolean isIncrementalFlashingForceDisabled ()

Gibt Folgendes zurück:
`boolean`

setAllowCrossReleaseFlashing

public void setAllowCrossReleaseFlashing (boolean allowCrossReleaseFlashing)

Parameter
`allowCrossReleaseFlashing`	`boolean`

setAllowUnzipBaseline

public void setAllowUnzipBaseline (boolean allowUnzipBaseline)

Parameter
`allowUnzipBaseline`	`boolean`

setApplySnapshot

public void setApplySnapshot (boolean applySnapshot)

Parameter
`applySnapshot`	`boolean`

setConfiguration

public void setConfiguration (IConfiguration configuration)

Fügt die verwendete IConfiguration ein.

Parameter
`configuration`	`IConfiguration`

setIgnoreHostOptions

public void setIgnoreHostOptions (boolean ignoreHostOptions)

Parameter
`ignoreHostOptions`	`boolean`

setTestLogger

public void setTestLogger (ITestLogger testLogger)

Fügt die ITestLogger-Instanz ein.

Parameter
`testLogger`	`ITestLogger`

setUp

public void setUp (TestInformation testInfo)

Parameter
`testInfo`	`TestInformation`

Löst aus
`BuildError`
`DeviceNotAvailableException`
`TargetSetupError`

setUpdateBootloaderFromUserspace

public void setUpdateBootloaderFromUserspace (boolean updateBootloaderFromUserspace)

Parameter
`updateBootloaderFromUserspace`	`boolean`

setUseIncrementalNewFlow

public void setUseIncrementalNewFlow (boolean useIncrementalNewFlow)

Parameter
`useIncrementalNewFlow`	`boolean`

setUserDataFlashOption

public void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

Option „userdata-flash“ festlegen

setWipeAfterApplySnapshot

public void setWipeAfterApplySnapshot (boolean wipeAfterApplySnapshot)

Parameter
`wipeAfterApplySnapshot`	`boolean`

tearDown

public void tearDown (TestInformation testInfo, 
                Throwable e)

Parameter
`testInfo`	`TestInformation`
`e`	`Throwable`

Löst aus
`DeviceNotAvailableException`

useMerkleTreeComparison

public void useMerkleTreeComparison (boolean enableMerkleTreeComparison)

Parameter
`enableMerkleTreeComparison`	`boolean`

Geschützte Methoden

checkDeviceProductType

protected void checkDeviceProductType (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Mögliche Prüfung vor dem Flashen, um sicherzustellen, dass das Gerät den Build-Informationen entspricht.

Parameter
`device`	`ITestDevice`: Das `ITestDevice`, das geflasht werden soll.
`deviceBuild`	`IDeviceBuildInfo`: Der `IDeviceBuildInfo`, der zum Flashen verwendet wird.

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

createFlasher

protected abstract IDeviceFlasher createFlasher (ITestDevice device)

Erstellen Sie IDeviceFlasher zur Verwendung. Kann von abgeleiteten Klassen überschrieben werden

Parameter
`device`	`ITestDevice`

Gibt Folgendes zurück:
`IDeviceFlasher`

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

getDeviceBootWaitTime

protected long getDeviceBootWaitTime ()

Ruft die Wartezeit für den Gerätestart ab

Gibt Folgendes zurück:
`long`

getHostOptions

protected IHostOptions getHostOptions ()

Ruft die zu verwendende IHostOptions-Instanz ab.

Für Einheitentests verfügbar gemacht

Gibt Folgendes zurück:
`IHostOptions`

reportFlashMetrics

protected void reportFlashMetrics (String branch, 
                String buildFlavor, 
                String buildId, 
                String serial, 
                long queueTime, 
                long flashingTime, 
                CommandStatus flashingStatus)

Meldet Daten zum Timing des Geräte-Flashings an das Messwert-Backend

Parameter
`branch`	`String`: der Zweig, aus dem der Geräte-Build stammt
`buildFlavor`	`String`: die Build-Variante des Geräte-Builds
`buildId`	`String`: die Build-Nummer des Geräte-Builds
`serial`	`String`: die Seriennummer des Geräts
`queueTime`	`long`: die Zeit, die mit dem Warten auf ein blinkendes Limit verbracht wurde
`flashingTime`	`long`: die Zeit, die für das Flashen des Geräte-Image-ZIP benötigt wurde
`flashingStatus`	`CommandStatus`: der Ausführungsstatus des Flash-Befehls

setSkipPostFlashBuildIdCheck

protected void setSkipPostFlashBuildIdCheck (boolean skipPostFlashBuildIdCheck)

Parameter
`skipPostFlashBuildIdCheck`	`boolean`

setUseIncrementalFlashing

protected void setUseIncrementalFlashing (boolean incrementalFlashing)

Parameter
`incrementalFlashing`	`boolean`