A partire dal 27 marzo 2025, ti consigliamo di utilizzare android-latest-release anziché aosp-main per compilare e contribuire ad AOSP. Per ulteriori informazioni, vedi Modifiche ad AOSP.

Questa pagina è stata tradotta dall'API Cloud Translation.

DeviceFlashPreparer

public abstract class DeviceFlashPreparer
extends BaseTargetPreparer implements IConfigurationReceiver, ITestLoggerReceiver

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

Classi di sottoclasse dirette note

FastbootUpdateBootstrapPreparer

FastbootUpdateBootstrapPreparer Un ITargetPreparer che esegue il 'inizializzazione di file specificati (bootloader, radio, file ZIP dell'immagine del dispositivo) in IDeviceBuildInfo per eseguire il flashing dei dispositivi con FastbootDeviceFlasher, quindi inietta gli attributi del dispositivo post-boot nelle informazioni di compilazione a fini di generazione di report sui risultati.

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

Riepilogo

Costruttori pubblici
`DeviceFlashPreparer()`

Metodi pubblici
`void`	`addAllowedBranchForTransitionInIncremental(String branch)`
`void`	`addBranchTransitionInIncremental(String origin, String destination)`
`IBuildInfo`	`getBuild(TestInformation testInfo)` Avvolgi getBuildInfo in modo da avere la possibilità di sostituirlo 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)` Invia 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)` Impostare l'opzione userdata-flash
`void`	`setWipeAfterApplySnapshot(boolean wipeAfterApplySnapshot)`
`void`	`tearDown(TestInformation testInfo, Throwable e)`
`void`	`useMerkleTreeComparison(boolean enableMerkleTreeComparison)`

Metodi protetti
`void`	`checkDeviceProductType(ITestDevice device, IDeviceBuildInfo deviceBuild)` Possibile controllo prima del flashing per assicurarsi che il dispositivo sia come previsto rispetto alle informazioni di build.
`abstract IDeviceFlasher`	`createFlasher(ITestDevice device)` Crea `IDeviceFlasher` da utilizzare.
`long`	`getDeviceBootWaitTime()` Recupera il tempo di attesa dell'avvio del dispositivo
`IHostOptions`	`getHostOptions()` Recupera l'istanza `IHostOptions` da utilizzare.
`void`	`reportFlashMetrics(String branch, String buildFlavor, String buildId, String serial, long queueTime, long flashingTime, CommandStatus flashingStatus)` Segnala i dati relativi ai tempi di intermittenza 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`

getBuild

public IBuildInfo getBuild (TestInformation testInfo)

Avvolgi getBuildInfo in modo da avere la possibilità di sostituirlo 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)

Invia 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)

Impostare 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

checkDeviceProductType

protected void checkDeviceProductType (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

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

Parametri
`device`	`ITestDevice`: il `ITestDevice` da far lampeggiare.
`deviceBuild`	`IDeviceBuildInfo`: il `IDeviceBuildInfo` utilizzato per il flashing.

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 ()

Recupera il tempo di attesa dell'avvio del dispositivo

Ritorni
`long`

getHostOptions

protected IHostOptions getHostOptions ()

Recupera l'istanza IHostOptions da utilizzare.

Esposto per i test delle unità

Ritorni
`IHostOptions`

reportFlashMetrics

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

Segnala i dati relativi ai tempi di intermittenza del dispositivo al backend delle metriche

Parametri
`branch`	`String`: il ramo da cui ha avuto origine la compilazione del dispositivo
`buildFlavor`	`String`: il tipo di build del dispositivo
`buildId`	`String`: il numero 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 impiegato per il flashing dell'immagine del dispositivo in formato ZIP
`flashingStatus`	`CommandStatus`: lo stato di esecuzione del comando di intermittenza

setSkipPostFlashBuildIdCheck

protected void setSkipPostFlashBuildIdCheck (boolean skipPostFlashBuildIdCheck)

Parametri
`skipPostFlashBuildIdCheck`	`boolean`

setUseIncrementalFlashing

protected void setUseIncrementalFlashing (boolean incrementalFlashing)

Parametri
`incrementalFlashing`	`boolean`