DeviceFlashPreparer

public abstract class DeviceFlashPreparer
extends BaseTargetPreparer implements IConfigurationReceiver, ITestLoggerReceiver

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

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

Résumé

Constructeurs publics

DeviceFlashPreparer()

Méthodes publiques

void addAllowedBranchForTransitionInIncremental(String branch)
void addBranchTransitionInIncremental(String origin, String destination)
void addFlasherExtraMetadata( metadata)
IBuildInfo getBuild(TestInformation testInfo)

Encapsulez getBuildInfo afin de pouvoir 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 en cours d'utilisation.

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

boolean checkAntiRollback(IDeviceFlasher flasher, ITestDevice device, IDeviceBuildInfo deviceBuild)
void checkDeviceProductType(ITestDevice device, IDeviceBuildInfo deviceBuild)

Vérifiez que l'appareil correspond aux informations de compilation avant de le flasher.

abstract IDeviceFlasher createFlasher(ITestDevice device)

Créez un IDeviceFlasher à utiliser.

long getDeviceBootWaitTime()

Obtient le temps d'attente de démarrage de l'appareil

IHostOptions getHostOptions()

Obtient l'instance IHostOptions à utiliser.

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

Envoie les données de timing du flash 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

addFlasherExtraMetadata

public void addFlasherExtraMetadata ( metadata)

Paramètres
metadata

getBuild

public IBuildInfo getBuild (TestInformation testInfo)

Encapsulez getBuildInfo pour pouvoir 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 en cours d'utilisation.

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

checkAntiRollback

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

Paramètres
flasher IDeviceFlasher

device ITestDevice

deviceBuild IDeviceBuildInfo

Renvoie
boolean

Génère
DeviceNotAvailableException

checkDeviceProductType

protected void checkDeviceProductType (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Vérifiez que l'appareil correspond aux informations de compilation avant de le flasher.

Paramètres
device ITestDevice : ITestDevice à faire clignoter.
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 ()

Obtient le temps d'attente de démarrage de l'appareil

Renvoie
long

getHostOptions

protected IHostOptions getHostOptions ()

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

Envoie les données de timing du flash de l'appareil au backend des métriques

Paramètres
branch String : branche à partir de laquelle la version de l'appareil a été créée
buildFlavor String : variante de compilation de la compilation de l'appareil
buildId String : numéro de compilation de l'appareil
serial String : numéro de série de l'appareil
queueTime long : temps passé à attendre qu'une limite clignotante 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