À partir du 27 mars 2025, nous vous recommandons d'utiliser android-latest-release au lieu de aosp-main pour créer et contribuer à AOSP. Pour en savoir plus, consultez la section Modifications apportées à AOSP.

Cette page a été traduite par l'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

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`