A partire dal 2026, per allinearci al nostro modello di sviluppo stabile del trunk e garantire la stabilità della piattaforma per l'ecosistema, pubblicheremo il codice sorgente su AOSP nel secondo e nel quarto trimestre. Per la creazione e il contributo ad AOSP, consigliamo di utilizzare android-latest-release anziché aosp-main. Il ramo del manifest android-latest-release farà sempre riferimento alla release più recente inviata ad AOSP. Per saperne di più, vedi Modifiche ad AOSP.

DeviceFlashPreparer

public abstract class DeviceFlashPreparer
extends BaseTargetPreparer implements IConfigurationReceiver, ITestLoggerReceiver

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

Sottoclassi dirette note

FastbootUpdateBootstrapPreparer

FastbootUpdateBootstrapPreparer Un ITargetPreparer che organizza i file specificati (bootloader, radio, zip dell'immagine del dispositivo) in IDeviceBuildInfo per eseguire il flashing dei dispositivi con FastbootDeviceFlasher, quindi inserisce gli attributi del dispositivo post-avvio nelle informazioni sulla build a scopo di generazione dei report sui risultati.

Un ITargetPreparer che mostra un'immagine sull'hardware Android fisico.

Riepilogo

Costruttori pubblici
`DeviceFlashPreparer()`

Metodi pubblici
`void`	`addAllowedBranchForTransitionInIncremental(String branch)`
`void`	`addBranchTransitionInIncremental(String origin, String destination)`
`void`	`addFlasherExtraMetadata( metadata)`
`IBuildInfo`	`getBuild(TestInformation testInfo)` Esegui il wrapping di getBuildInfo in modo da poterlo sostituire per scenari specifici.
`ITestLogger`	`getTestLogger()`
`boolean`	`isIncrementalFlashingEnabled()`
`boolean`	`isIncrementalFlashingForceDisabled()`
`void`	`setAllowCrossReleaseFlashing(boolean allowCrossReleaseFlashing)`
`void`	`setAllowUnzipBaseline(boolean allowUnzipBaseline)`
`void`	`setApplySnapshot(boolean applySnapshot)`
`void`	`setConfiguration(IConfiguration configuration)` Inserisce il `IConfiguration` in uso.
`void`	`setIgnoreHostOptions(boolean ignoreHostOptions)`
`void`	`setTestLogger(ITestLogger testLogger)` Inserisce l'istanza `ITestLogger`
`void`	`setUp(TestInformation testInfo)`
`void`	`setUpdateBootloaderFromUserspace(boolean updateBootloaderFromUserspace)`
`void`	`setUseIncrementalNewFlow(boolean useIncrementalNewFlow)`
`void`	`setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption)` Imposta l'opzione userdata-flash
`void`	`setWipeAfterApplySnapshot(boolean wipeAfterApplySnapshot)`
`void`	`tearDown(TestInformation testInfo, Throwable e)`
`void`	`useMerkleTreeComparison(boolean enableMerkleTreeComparison)`

Metodi protetti
`boolean`	`checkAntiRollback(IDeviceFlasher flasher, ITestDevice device, IDeviceBuildInfo deviceBuild)`
`void`	`checkDeviceProductType(ITestDevice device, IDeviceBuildInfo deviceBuild)` Possibile controllo prima del flashing per assicurarsi che il dispositivo sia come previsto rispetto alle informazioni sulla build.
`abstract IDeviceFlasher`	`createFlasher(ITestDevice device)` Crea `IDeviceFlasher` da utilizzare.
`long`	`getDeviceBootWaitTime()` Ottiene il tempo di attesa per l'avvio del dispositivo
`IHostOptions`	`getHostOptions()` Ottiene l'istanza `IHostOptions` da utilizzare.
`void`	`reportFlashMetrics(String branch, String buildFlavor, String buildId, String serial, long queueTime, long flashingTime, CommandStatus flashingStatus)` Invia i dati di temporizzazione del flashing del dispositivo al backend delle metriche
`void`	`setSkipPostFlashBuildIdCheck(boolean skipPostFlashBuildIdCheck)`
`void`	`setUseIncrementalFlashing(boolean incrementalFlashing)`

Costruttori pubblici

DeviceFlashPreparer

public DeviceFlashPreparer ()

Metodi pubblici

addAllowedBranchForTransitionInIncremental

public void addAllowedBranchForTransitionInIncremental (String branch)

Parametri
`branch`	`String`

addBranchTransitionInIncremental

public void addBranchTransitionInIncremental (String origin, 
                String destination)

Parametri
`origin`	`String`
`destination`	`String`

addFlasherExtraMetadata

public void addFlasherExtraMetadata ( metadata)

Parametri
`metadata`

getBuild

public IBuildInfo getBuild (TestInformation testInfo)

Esegui il wrapping di getBuildInfo in modo da poterlo sostituire per scenari specifici.

Parametri
`testInfo`	`TestInformation`

Ritorni
`IBuildInfo`

getTestLogger

public ITestLogger getTestLogger ()

Ritorni
`ITestLogger`

isIncrementalFlashingEnabled

public boolean isIncrementalFlashingEnabled ()

Ritorni
`boolean`

isIncrementalFlashingForceDisabled

public boolean isIncrementalFlashingForceDisabled ()

Ritorni
`boolean`

setAllowCrossReleaseFlashing

public void setAllowCrossReleaseFlashing (boolean allowCrossReleaseFlashing)

Parametri
`allowCrossReleaseFlashing`	`boolean`

setAllowUnzipBaseline

public void setAllowUnzipBaseline (boolean allowUnzipBaseline)

Parametri
`allowUnzipBaseline`	`boolean`

setApplySnapshot

public void setApplySnapshot (boolean applySnapshot)

Parametri
`applySnapshot`	`boolean`

setConfiguration

public void setConfiguration (IConfiguration configuration)

Inserisce il IConfiguration in uso.

Parametri
`configuration`	`IConfiguration`

setIgnoreHostOptions

public void setIgnoreHostOptions (boolean ignoreHostOptions)

Parametri
`ignoreHostOptions`	`boolean`

setTestLogger

public void setTestLogger (ITestLogger testLogger)

Inserisce l'istanza ITestLogger

Parametri
`testLogger`	`ITestLogger`

setUp

public void setUp (TestInformation testInfo)

Parametri
`testInfo`	`TestInformation`

Lanci
`BuildError`
`DeviceNotAvailableException`
`TargetSetupError`

setUpdateBootloaderFromUserspace

public void setUpdateBootloaderFromUserspace (boolean updateBootloaderFromUserspace)

Parametri
`updateBootloaderFromUserspace`	`boolean`

setUseIncrementalNewFlow

public void setUseIncrementalNewFlow (boolean useIncrementalNewFlow)

Parametri
`useIncrementalNewFlow`	`boolean`

setUserDataFlashOption

public void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

Imposta l'opzione userdata-flash

setWipeAfterApplySnapshot

public void setWipeAfterApplySnapshot (boolean wipeAfterApplySnapshot)

Parametri
`wipeAfterApplySnapshot`	`boolean`

tearDown

public void tearDown (TestInformation testInfo, 
                Throwable e)

Parametri
`testInfo`	`TestInformation`
`e`	`Throwable`

Lanci
`DeviceNotAvailableException`

useMerkleTreeComparison

public void useMerkleTreeComparison (boolean enableMerkleTreeComparison)

Parametri
`enableMerkleTreeComparison`	`boolean`

Metodi protetti

checkAntiRollback

protected boolean checkAntiRollback (IDeviceFlasher flasher, 
                ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Parametri
`flasher`	`IDeviceFlasher`
`device`	`ITestDevice`
`deviceBuild`	`IDeviceBuildInfo`

Ritorni
`boolean`

Lanci
`DeviceNotAvailableException`

checkDeviceProductType

protected void checkDeviceProductType (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Possibile controllo prima del flashing per assicurarsi che il dispositivo sia come previsto rispetto alle informazioni sulla build.

Parametri
`device`	`ITestDevice`: il `ITestDevice` da flashare.
`deviceBuild`	`IDeviceBuildInfo`: il `IDeviceBuildInfo` utilizzato per il flash.

Lanci
	com.android.tradefed.targetprep.BuildError
	com.android.tradefed.device.DeviceNotAvailableException
`BuildError`
`DeviceNotAvailableException`

createFlasher

protected abstract IDeviceFlasher createFlasher (ITestDevice device)

Crea IDeviceFlasher da utilizzare. Le sottoclassi possono eseguire l'override

Parametri
`device`	`ITestDevice`

Ritorni
`IDeviceFlasher`

Lanci
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getDeviceBootWaitTime

protected long getDeviceBootWaitTime ()

Ottiene il tempo di attesa per l'avvio del dispositivo

Ritorni
`long`

getHostOptions

protected IHostOptions getHostOptions ()

Ottiene l'istanza IHostOptions da utilizzare.

Esposto per il test delle unità

Ritorni
`IHostOptions`

reportFlashMetrics

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

Invia i dati di temporizzazione del flashing del dispositivo al backend delle metriche

Parametri
`branch`	`String`: il ramo da cui ha avuto origine la build del dispositivo
`buildFlavor`	`String`: la variante di build della build del dispositivo
`buildId`	`String`: il numero di build della build del dispositivo
`serial`	`String`: il numero di serie del dispositivo
`queueTime`	`long`: il tempo trascorso in attesa che un limite lampeggiante diventi disponibile
`flashingTime`	`long`: il tempo trascorso a caricare il file zip dell'immagine del dispositivo
`flashingStatus`	`CommandStatus`: lo stato di esecuzione del comando di flashing

setSkipPostFlashBuildIdCheck

protected void setSkipPostFlashBuildIdCheck (boolean skipPostFlashBuildIdCheck)

Parametri
`skipPostFlashBuildIdCheck`	`boolean`

setUseIncrementalFlashing

protected void setUseIncrementalFlashing (boolean incrementalFlashing)

Parametri
`incrementalFlashing`	`boolean`