DeviceFlashPreparer

public abstract class DeviceFlashPreparer
extends BaseTargetPreparer implements IConfigurationReceiver, ITestLoggerReceiver

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

Sous-classes directes connues FastbootUpdateBootstrapPreparer FastbootUpdateBootstrapPreparer Un ITargetPreparer qui met en scène des fichiers spécifiés (chargeur de démarrage, radio, fichier ZIP de l'image de l'appareil) dans IDeviceBuildInfo pour flasher les appareils avec FastbootDeviceFlasher, puis injecte des attributs d'appareil post-démarrage dans les informations de compilation à des fins de création de rapports sur les résultats.

---

ITargetPreparer qui flashe une image sur du matériel Android physique.

Résumé

Constructeurs publics
DeviceFlashPreparer()

Méthodes publiques
void	addAllowedBranchForTransitionInIncremental(String branch)
void	addBranchTransitionInIncremental(String origin, String destination)
IBuildInfo	getBuild(TestInformation testInfo) Encapsulez getBuildInfo afin que nous puissions le remplacer dans des scénarios spécifiques.
ITestLogger	getTestLogger()
boolean	isIncrementalFlashingEnabled()
boolean	isIncrementalFlashingForceDisabled()
void	setAllowCrossReleaseFlashing(boolean allowCrossReleaseFlashing)
void	setAllowUnzipBaseline(boolean allowUnzipBaseline)
void	setApplySnapshot(boolean applySnapshot)
void	setConfiguration(IConfiguration configuration) Injecte le IConfiguration utilisé.
void	setIgnoreHostOptions(boolean ignoreHostOptions)
void	setTestLogger(ITestLogger testLogger) Injecte l'instance ITestLogger
void	setUp(TestInformation testInfo)
void	setUpdateBootloaderFromUserspace(boolean updateBootloaderFromUserspace)
void	setUseIncrementalNewFlow(boolean useIncrementalNewFlow)
void	setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption) Définir l'option userdata-flash
void	setWipeAfterApplySnapshot(boolean wipeAfterApplySnapshot)
void	tearDown(TestInformation testInfo, Throwable e)
void	useMerkleTreeComparison(boolean enableMerkleTreeComparison)

Méthodes protégées
void	checkDeviceProductType(ITestDevice device, IDeviceBuildInfo deviceBuild) Vérification possible avant le flashage pour s'assurer que l'appareil est conforme aux informations de compilation.
abstract IDeviceFlasher	createFlasher(ITestDevice device) Créez un IDeviceFlasher à utiliser.
long	getDeviceBootWaitTime() Récupère le temps d'attente de démarrage de l'appareil
IHostOptions	getHostOptions() Récupère l'instance IHostOptions à utiliser.
void	reportFlashMetrics(String branch, String buildFlavor, String buildId, String serial, long queueTime, long flashingTime, CommandStatus flashingStatus) Transmet les données de synchronisation du clignotement de l'appareil au backend des métriques
void	setSkipPostFlashBuildIdCheck(boolean skipPostFlashBuildIdCheck)
void	setUseIncrementalFlashing(boolean incrementalFlashing)

Constructeurs publics

DeviceFlashPreparer

public DeviceFlashPreparer ()

Méthodes publiques

addAllowedBranchForTransitionInIncremental

public void addAllowedBranchForTransitionInIncremental (String branch)

Paramètres
branch	String

addBranchTransitionInIncremental

public void addBranchTransitionInIncremental (String origin, 
                String destination)

Paramètres
origin	String
destination	String

getBuild

public IBuildInfo getBuild (TestInformation testInfo)

Encapsulez getBuildInfo afin que nous puissions le remplacer dans des scénarios spécifiques.

Paramètres
testInfo	TestInformation

Renvoie
IBuildInfo

getTestLogger

public ITestLogger getTestLogger ()

Renvoie
ITestLogger

isIncrementalFlashingEnabled

public boolean isIncrementalFlashingEnabled ()

Renvoie
boolean

isIncrementalFlashingForceDisabled

public boolean isIncrementalFlashingForceDisabled ()

Renvoie
boolean

setAllowCrossReleaseFlashing

public void setAllowCrossReleaseFlashing (boolean allowCrossReleaseFlashing)

Paramètres
allowCrossReleaseFlashing	boolean

setAllowUnzipBaseline

public void setAllowUnzipBaseline (boolean allowUnzipBaseline)

Paramètres
allowUnzipBaseline	boolean

setApplySnapshot

public void setApplySnapshot (boolean applySnapshot)

Paramètres
applySnapshot	boolean

setConfiguration

public void setConfiguration (IConfiguration configuration)

Injecte le IConfiguration utilisé.

Paramètres
configuration	IConfiguration

setIgnoreHostOptions

public void setIgnoreHostOptions (boolean ignoreHostOptions)

Paramètres
ignoreHostOptions	boolean

setTestLogger

public void setTestLogger (ITestLogger testLogger)

Injecte l'instance ITestLogger

Paramètres
testLogger	ITestLogger

setUp

public void setUp (TestInformation testInfo)

Paramètres
testInfo	TestInformation

Génère
BuildError
DeviceNotAvailableException
TargetSetupError

setUpdateBootloaderFromUserspace

public void setUpdateBootloaderFromUserspace (boolean updateBootloaderFromUserspace)

Paramètres
updateBootloaderFromUserspace	boolean

setUseIncrementalNewFlow

public void setUseIncrementalNewFlow (boolean useIncrementalNewFlow)

Paramètres
useIncrementalNewFlow	boolean

setUserDataFlashOption

public void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

Définir l'option userdata-flash

setWipeAfterApplySnapshot

public void setWipeAfterApplySnapshot (boolean wipeAfterApplySnapshot)

Paramètres
wipeAfterApplySnapshot	boolean

tearDown

public void tearDown (TestInformation testInfo, 
                Throwable e)

Paramètres
testInfo	TestInformation
e	Throwable

Génère
DeviceNotAvailableException

useMerkleTreeComparison

public void useMerkleTreeComparison (boolean enableMerkleTreeComparison)

Paramètres
enableMerkleTreeComparison	boolean

Méthodes protégées

checkDeviceProductType

protected void checkDeviceProductType (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Vérification possible avant le flashage pour s'assurer que l'appareil est conforme aux informations de compilation.

Paramètres
device	ITestDevice: ITestDevice à flasher.
deviceBuild	IDeviceBuildInfo: IDeviceBuildInfo utilisé pour le flash.

Génère
	com.android.tradefed.targetprep.BuildError
	com.android.tradefed.device.DeviceNotAvailableException
BuildError
DeviceNotAvailableException

createFlasher

protected abstract IDeviceFlasher createFlasher (ITestDevice device)

Créez un IDeviceFlasher à utiliser. Les sous-classes peuvent remplacer

Paramètres
device	ITestDevice

Renvoie
IDeviceFlasher

Génère
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getDeviceBootWaitTime

protected long getDeviceBootWaitTime ()

Récupère le temps d'attente de démarrage de l'appareil

Renvoie
long

getHostOptions

protected IHostOptions getHostOptions ()

Récupère l'instance IHostOptions à utiliser.

Exposé pour les tests unitaires

Renvoie
IHostOptions

reportFlashMetrics

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

Transmet les données de synchronisation du clignotement de l'appareil au backend des métriques

Paramètres
branch	String: branche d'où provient le build de l'appareil
buildFlavor	String: version de la compilation de l'appareil
buildId	String: numéro de build de l'appareil
serial	String: numéro de série de l'appareil
queueTime	long: temps d'attente avant qu'une limite clignotante ne devienne disponible
flashingTime	long: temps passé à flasher le fichier ZIP de l'image de l'appareil
flashingStatus	CommandStatus: état d'exécution de la commande de clignotement

setSkipPostFlashBuildIdCheck

protected void setSkipPostFlashBuildIdCheck (boolean skipPostFlashBuildIdCheck)

Paramètres
skipPostFlashBuildIdCheck	boolean

setUseIncrementalFlashing

protected void setUseIncrementalFlashing (boolean incrementalFlashing)

Paramètres
incrementalFlashing	boolean