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