Google s'est engagé à promouvoir l'équité raciale pour les communautés noires. Regarde comment.
Cette page a été traduite par l'API Cloud Translation.
Switch to English

FastbootDeviceFlasher

public class FastbootDeviceFlasher
extends Object implements IDeviceFlasher

java.lang.Object
com.android.tradefed.targetprep.FastbootDeviceFlasher


Une classe qui s'appuie sur fastboot pour flasher une image sur du matériel Android physique.

Résumé

Des champs

public static final String BASEBAND_IMAGE_NAME

Constructeurs publics

FastbootDeviceFlasher ()

Méthodes publiques

void flash ( ITestDevice device, IDeviceBuildInfo deviceBuild)

Les flashs se construisent sur l'appareil.

CommandStatus getSystemFlashingStatus ()

Récupérez l'état d'exécution de la commande pour les partitions système primaires clignotantes.

IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

Obtient si l'image des données utilisateur doit être flashée, effacée ou conservée

void overrideDeviceOptions ( ITestDevice device)

Remplacer les options d'un appareil.

void setDataWipeSkipList ( dataWipeSkipList) setDataWipeSkipList ( dataWipeSkipList)

Définit la liste des chemins sous /data pour éviter l'effacement lors de l'utilisation d' ITestsZipInstaller

Notez que la granularité de la liste de sauts est des enfants directs de /data .

void setFlashOptions ( flashOptions) setFlashOptions ( flashOptions)

Définit une liste d'options à transmettre avec les commandes flash / update.

void setFlashingResourcesRetriever ( IFlashingResourcesRetriever retriever)

Définit le mécanisme par lequel le clignotant peut récupérer les fichiers de ressources pour le clignotement.

void setForceSystemFlash (boolean forceSystemFlash)

Définit si le système doit toujours être flashé même si la version actuelle est exécutée

void setUserDataFlashOption ( IDeviceFlasher.UserDataFlashOption flashOption)

Indique si l'image des données utilisateur doit être flashée, effacée ou conservée

void setWipeTimeout (long timeout)

Définissez le délai d’effacement des données.

Méthodes protégées

void checkAndFlashBaseband ( ITestDevice device, IDeviceBuildInfo deviceBuild)

Si nécessaire, flashez l'image de la bande de base sur l'appareil.

boolean checkAndFlashBootloader ( ITestDevice device, IDeviceBuildInfo deviceBuild)

Si nécessaire, flashez l'image du chargeur de démarrage sur l'appareil.

boolean checkAndFlashSystem ( ITestDevice device, String systemBuildId, String systemBuildFlavor, IDeviceBuildInfo deviceBuild)

Si nécessaire, flashez l'image système sur l'appareil.

boolean checkShouldFlashBaseband ( ITestDevice device, IDeviceBuildInfo deviceBuild)

Vérifiez si la bande de base de l'appareil fourni doit être flashée.

IFlashingResourcesParser createFlashingResourcesParser ( IDeviceBuildInfo localBuild, DeviceDescriptor descriptor)

Méthode d'usine pour créer un IFlashingResourcesParser .

void downloadExtraImageFiles ( IFlashingResourcesParser resourceParser, IFlashingResourcesRetriever retriever, IDeviceBuildInfo localBuild)

Hook pour permettre aux sous-classes de télécharger des fichiers image personnalisés supplémentaires si nécessaire.

void downloadFlashingResources ( ITestDevice device, IDeviceBuildInfo localBuild)

Télécharge les fichiers d'image clignotants supplémentaires nécessaires

String executeFastbootCmd ( ITestDevice device, String... cmdArgs)

Méthode d'assistance pour exécuter la commande fastboot.

String executeLongFastbootCmd ( ITestDevice device, String... cmdArgs)

Méthode d'assistance pour exécuter une commande fastboot de longue durée.

void flashBaseband ( ITestDevice device, File basebandImageFile)

Clignote l'image de bande de base donnée et redémarre dans le chargeur de démarrage

void flashBootloader ( ITestDevice device, File bootloaderImageFile)

Clignote l'image du chargeur de démarrage donnée et redémarre dans le chargeur de démarrage

void flashExtraImages ( ITestDevice device, IDeviceBuildInfo deviceBuild)

Flashez toutes les partitions spécifiques au périphérique avant de faire clignoter le système et de redémarrer.

void flashPartition ( ITestDevice device, File imgFile, String partition)

Flasher une partition individuelle d'un périphérique

void flashSystem ( ITestDevice device, IDeviceBuildInfo deviceBuild)

Flashez l'image système sur l'appareil.

void flashUserData ( ITestDevice device, IDeviceBuildInfo deviceBuild)

Clignotez la partition des données utilisateur sur l'appareil.

void flashUserDataFromDeviceImageFile ( ITestDevice device, IDeviceBuildInfo deviceBuild)

Extrait le userdata.img du fichier image de l'appareil et le fait clignoter sur l'appareil

String getBootPartitionName ()

Obtenez le nom de la partition de démarrage pour ce clignotant de périphérique.

String getBootloaderFilePrefix ( ITestDevice device)

Obtenez le préfixe de fichier du chargeur de démarrage.

String getCurrentSlot ( ITestDevice device)

Méthode d'assistance pour récupérer l'emplacement actuel (pour les appareils compatibles A / B).

IFlashingResourcesRetriever getFlashingResourcesRetriever ()
String getImageVersion ( ITestDevice device, String imageName)

Méthode d'assistance pour obtenir la version actuelle de l'image sur l'appareil.

IRunUtil getRunUtil ()

Exposé pour les tests.

void handleUserDataFlashing ( ITestDevice device, IDeviceBuildInfo deviceBuild)

Gérer le clignotement de la partition de données utilisateur / cache

boolean hasPartition ( ITestDevice device, String partition)

Vérifie avec le chargeur de démarrage si la partition spécifiée existe ou non

void preFlashSetup ( ITestDevice device, IDeviceBuildInfo deviceBuild)

Effectuez toute configuration de pré-clignotement supplémentaire requise.

void verifyRequiredBoards ( ITestDevice device, IFlashingResourcesParser resourceParser, String deviceProductType)

Vérifiez que le type de produit du périphérique prend en charge la version à flash.

void wipeCache ( ITestDevice device)

Essuyez la partition de cache sur l'appareil.

void wipePartition ( ITestDevice device, String partition)

Nettoyez la partition spécifiée avec `fastboot erase <nom>`

Des champs

BASEBAND_IMAGE_NAME

public static final String BASEBAND_IMAGE_NAME

Constructeurs publics

FastbootDeviceFlasher

public FastbootDeviceFlasher ()

Méthodes publiques

éclat

public void flash ( ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Les flashs se construisent sur l'appareil.

Retourne immédiatement après la fin du clignotement. Les appelants doivent attendre que l'appareil soit en ligne et disponible avant de procéder au test.

Paramètres
device ITestDevice : l' ITestDevice à flasher

deviceBuild IDeviceBuildInfo : l' IDeviceBuildInfo à flasher

Jette
DeviceNotAvailableException
TargetSetupError

getSystemFlashingStatus

public CommandStatus getSystemFlashingStatus ()

Récupérez l'état d'exécution de la commande pour les partitions système primaires clignotantes.

Notez que si les partitions système ne sont pas flashées (le système a déjà la construction à flasher), l'état de la commande peut être null

Retour
CommandStatus

getUserDataFlashOption

public IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

Obtient si l'image des données utilisateur doit être flashée, effacée ou conservée

Retour
IDeviceFlasher.UserDataFlashOption Si l'image des données utilisateur doit être flashée, effacée ou conservée

overrideDeviceOptions

public void overrideDeviceOptions ( ITestDevice device)

Remplacer les options d'un appareil. Utilisé pour remplacer les valeurs d'option par défaut si les valeurs par défaut ne sont pas prises en charge par un périphérique particulier.

setDataWipeSkipList

public void setDataWipeSkipList ( dataWipeSkipList)

Définit la liste des chemins sous /data pour éviter l'effacement lors de l'utilisation d' ITestsZipInstaller

Notez que la granularité de la liste de sauts est des enfants directs de /data .

Paramètres
dataWipeSkipList

setFlashOptions

public void setFlashOptions ( flashOptions)

Définit une liste d'options à transmettre avec les commandes flash / update.

setFlashingResourcesRetriever

public void setFlashingResourcesRetriever ( IFlashingResourcesRetriever retriever)

Définit le mécanisme par lequel le clignotant peut récupérer les fichiers de ressources pour le clignotement.

Paramètres
retriever IFlashingResourcesRetriever : le IFlashingResourcesRetriever à utiliser

setForceSystemFlash

public void setForceSystemFlash (boolean forceSystemFlash)

Définit si le système doit toujours être flashé même si la version actuelle est exécutée

setUserDataFlashOption

public void setUserDataFlashOption ( IDeviceFlasher.UserDataFlashOption flashOption)

Indique si l'image des données utilisateur doit être flashée, effacée ou conservée

setWipeTimeout

public void setWipeTimeout (long timeout)

Définissez le délai d’effacement des données.

Paramètres
timeout long

Méthodes protégées

checkAndFlashBaseband

protected void checkAndFlashBaseband ( ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Si nécessaire, flashez l'image de la bande de base sur l'appareil. Ne clignotera la bande de base que si la version actuelle sur l'appareil! = Version requise

Paramètres
device ITestDevice : l' ITestDevice à flasher

deviceBuild IDeviceBuildInfo : l' IDeviceBuildInfo qui contient l'image de bande de base à flasher

Jette
DeviceNotAvailableException si l'appareil n'est pas disponible
TargetSetupError si échec de flasher la bande de base

checkAndFlashBootloader

protected boolean checkAndFlashBootloader ( ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Si nécessaire, flashez l'image du chargeur de démarrage sur l'appareil.

Ne flashera le bootloader que si la version actuelle sur l'appareil! = Version requise.

Paramètres
device ITestDevice : l' ITestDevice à flasher

deviceBuild IDeviceBuildInfo : l' IDeviceBuildInfo qui contient l'image du chargeur de démarrage à flasher

Retour
boolean true si le chargeur de démarrage a été flashé, false s'il a été ignoré

Jette
DeviceNotAvailableException si l'appareil n'est pas disponible
TargetSetupError si échec de flasher le chargeur de démarrage

checkAndFlashSystem

protected boolean checkAndFlashSystem ( ITestDevice device, 
                String systemBuildId, 
                String systemBuildFlavor, 
                IDeviceBuildInfo deviceBuild)

Si nécessaire, flashez l'image système sur l'appareil.

Veuillez regarder ERROR(/#shouldFlashSystem(String,String,com.android.tradefed.build.IDeviceBuildInfo))

Quel que soit le chemin choisi, après l'exécution de la méthode, le périphérique doit démarrer dans l'espace utilisateur.

Paramètres
device ITestDevice : l' ITestDevice à flasher

systemBuildId String : l'ID de build actuel en cours d'exécution sur l'appareil

systemBuildFlavor String : la version actuelle de la version exécutée sur l'appareil

deviceBuild IDeviceBuildInfo : l' IDeviceBuildInfo qui contient l'image système à flasher

Retour
boolean true si le système a été flashé, false s'il a été ignoré

Jette
DeviceNotAvailableException si l'appareil n'est pas disponible
TargetSetupError si échec de flasher le chargeur de démarrage

checkShouldFlashBaseband

protected boolean checkShouldFlashBaseband ( ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Vérifiez si la bande de base de l'appareil fourni doit être flashée.

Paramètres
device ITestDevice : l' ITestDevice à vérifier

deviceBuild IDeviceBuildInfo : l' IDeviceBuildInfo qui contient l'image de bande de base à vérifier

Retour
boolean

Jette
DeviceNotAvailableException si l'appareil n'est pas disponible
TargetSetupError si échec de flasher la bande de base

createFlashingResourcesParser

protected IFlashingResourcesParser createFlashingResourcesParser ( IDeviceBuildInfo localBuild, 
                DeviceDescriptor descriptor)

Méthode d'usine pour créer un IFlashingResourcesParser .

Exposé pour les tests unitaires.

Paramètres
localBuild IDeviceBuildInfo : l' IDeviceBuildInfo à analyser

descriptor DeviceDescriptor : le descripteur de l'appareil flashé.

Retour
IFlashingResourcesParser un IFlashingResourcesParser créé par la méthode de fabrique.

Jette
TargetSetupError

downloadExtraImageFiles

protected void downloadExtraImageFiles ( IFlashingResourcesParser resourceParser, 
                IFlashingResourcesRetriever retriever, 
                IDeviceBuildInfo localBuild)

Hook pour permettre aux sous-classes de télécharger des fichiers image personnalisés supplémentaires si nécessaire.

Paramètres
resourceParser IFlashingResourcesParser : le IFlashingResourcesParser

retriever IFlashingResourcesRetriever : le IFlashingResourcesRetriever

localBuild IDeviceBuildInfo : le IDeviceBuildInfo

Jette
TargetSetupError

téléchargerFlashingResources

protected void downloadFlashingResources ( ITestDevice device, 
                IDeviceBuildInfo localBuild)

Télécharge les fichiers d'image clignotants supplémentaires nécessaires

Paramètres
device ITestDevice : l' ITestDevice pour télécharger des ressources

localBuild IDeviceBuildInfo : l' IDeviceBuildInfo à remplir. Suppose que le fichier image de l'appareil est déjà défini

Jette
DeviceNotAvailableException si l'appareil n'est pas disponible
TargetSetupError en cas d'échec de la récupération des ressources

executeFastbootCmd

protected String executeFastbootCmd ( ITestDevice device, 
                String... cmdArgs)

Méthode d'assistance pour exécuter la commande fastboot.

Paramètres
device ITestDevice : l' ITestDevice sur ITestDevice exécuter la commande

cmdArgs String : les arguments à fournir pour fastboot

Retour
String Chaîne la sortie stderr de la commande si elle n'est pas vide. Sinon renvoie le stdout Certaines commandes fastboot sont bizarres en ce sens qu'elles déchargent la sortie vers stderr en cas de succès

Jette
DeviceNotAvailableException si l'appareil n'est pas disponible
TargetSetupError si la commande fastboot échoue

executeLongFastbootCmd

protected String executeLongFastbootCmd ( ITestDevice device, 
                String... cmdArgs)

Méthode d'assistance pour exécuter une commande fastboot de longue durée.

Remarque: la plupart des commandes de ITestDevice#executeFastbootCommand(String...) s'exécutent normalement dans le délai imparti par ITestDevice#executeFastbootCommand(String...) . Cependant, lorsque plusieurs périphériques font clignoter des périphériques à la fois, les commandes de démarrage rapide peuvent prendre beaucoup plus de temps que la normale.

Paramètres
device ITestDevice : l' ITestDevice sur ITestDevice exécuter la commande

cmdArgs String : les arguments à fournir pour fastboot

Retour
String Chaîne la sortie stderr de la commande si elle n'est pas vide. Sinon renvoie le stdout Certaines commandes fastboot sont bizarres en ce sens qu'elles déchargent la sortie vers stderr en cas de succès

Jette
DeviceNotAvailableException si l'appareil n'est pas disponible
TargetSetupError si la commande fastboot échoue

flashBaseband

protected void flashBaseband ( ITestDevice device, 
                File basebandImageFile)

Clignote l'image de bande de base donnée et redémarre dans le chargeur de démarrage

Paramètres
device ITestDevice : l' ITestDevice à flasher

basebandImageFile File : l'image de la bande de base ERROR(/File)

Jette
DeviceNotAvailableException si l'appareil n'est pas disponible
TargetSetupError si échec de flasher la bande de base

flashBootloader

protected void flashBootloader ( ITestDevice device, 
                File bootloaderImageFile)

Clignote l'image du chargeur de démarrage donnée et redémarre dans le chargeur de démarrage

Paramètres
device ITestDevice : l' ITestDevice à flasher

bootloaderImageFile File : l' ERROR(/File) image du chargeur de démarrage ERROR(/File)

Jette
DeviceNotAvailableException si l'appareil n'est pas disponible
TargetSetupError s'il ne parvient pas à clignoter

flashExtraImages

protected void flashExtraImages ( ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Flashez toutes les partitions spécifiques au périphérique avant de faire clignoter le système et de redémarrer. No-op sauf si remplacé.

Paramètres
device ITestDevice : l' ITestDevice à flasher

deviceBuild IDeviceBuildInfo : l' IDeviceBuildInfo contenant les fichiers de construction

Jette
com.android.tradefed.device.DeviceNotAvailableException
TargetSetupError
DeviceNotAvailableException

flashPartition

protected void flashPartition ( ITestDevice device, 
                File imgFile, 
                String partition)

Flasher une partition individuelle d'un périphérique

Paramètres
device ITestDevice : l' ITestDevice à flasher

imgFile File : une ERROR(/File) pointant vers l'image à flasher

partition String : le nom de la partition à flasher

Jette
DeviceNotAvailableException
TargetSetupError

flashSystem

protected void flashSystem ( ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Flashez l'image système sur l'appareil.

Paramètres
device ITestDevice : l' ITestDevice à flasher

deviceBuild IDeviceBuildInfo : l' IDeviceBuildInfo à flasher

Jette
DeviceNotAvailableException si l'appareil n'est pas disponible
TargetSetupError si la commande fastboot échoue

flashUserData

protected void flashUserData ( ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Clignote la partition des données utilisateur sur l'appareil.

Paramètres
device ITestDevice : l' ITestDevice à flasher

deviceBuild IDeviceBuildInfo : l' IDeviceBuildInfo qui contient les fichiers à flasher

Jette
DeviceNotAvailableException si l'appareil n'est pas disponible
TargetSetupError en cas d'échec du flashage des données utilisateur

flashUserDataFromDeviceImageFile

protected void flashUserDataFromDeviceImageFile ( ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Extrait le userdata.img du fichier image de l'appareil et le fait clignoter sur l'appareil

Paramètres
device ITestDevice : l' ITestDevice à flasher

deviceBuild IDeviceBuildInfo : l' IDeviceBuildInfo qui contient les fichiers à flasher

Jette
DeviceNotAvailableException si l'appareil n'est pas disponible
TargetSetupError en cas d'échec de l'extraction ou du flash des données utilisateur

getBootPartitionName

protected String getBootPartitionName ()

Obtenez le nom de la partition de démarrage pour ce clignotant de périphérique.

La valeur par défaut est «hboot». Les sous-classes doivent être remplacées si nécessaire.

Retour
String

getBootloaderFilePrefix

protected String getBootloaderFilePrefix ( ITestDevice device)

Obtenez le préfixe de fichier du chargeur de démarrage.

La valeur par défaut est getBootPartitionName() . Les sous-classes doivent être remplacées si nécessaire.

Paramètres
device ITestDevice : l' ITestDevice à flasher

Retour
String

Jette
DeviceNotAvailableException si l'appareil n'est pas disponible
TargetSetupError si impossible d'obtenir le préfixe

getCurrentSlot

protected String getCurrentSlot ( ITestDevice device)

Méthode d'assistance pour récupérer l'emplacement actuel (pour les appareils compatibles A / B).

Paramètres
device ITestDevice : l' ITestDevice sur ITestDevice exécuter la commande.

Retour
String "a", "b" ou null (si le périphérique n'est pas compatible A / B)

Jette
com.android.tradefed.device.DeviceNotAvailableException
TargetSetupError
DeviceNotAvailableException

getFlashingResourcesRetriever

protected IFlashingResourcesRetriever getFlashingResourcesRetriever ()

Retour
IFlashingResourcesRetriever

getImageVersion

protected String getImageVersion ( ITestDevice device, 
                String imageName)

Méthode d'assistance pour obtenir la version actuelle de l'image sur l'appareil.

Paramètres
device ITestDevice : l' ITestDevice sur ITestDevice exécuter la commande

imageName String : le nom de l'image à obtenir.

Retour
String Chaîne la sortie stdout de la commande

Jette
DeviceNotAvailableException si l'appareil n'est pas disponible
TargetSetupError si la commande fastboot échoue ou si la version n'a pas pu être déterminée

getRunUtil

protected IRunUtil getRunUtil ()

Exposé pour les tests.

Retour
IRunUtil

handleUserDataFlashing

protected void handleUserDataFlashing ( ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Gérer le clignotement de la partition de données utilisateur / cache

Paramètres
device ITestDevice : l' ITestDevice à flasher

deviceBuild IDeviceBuildInfo : l' IDeviceBuildInfo qui contient les fichiers à flasher

Jette
com.android.tradefed.device.DeviceNotAvailableException
TargetSetupError
DeviceNotAvailableException

hasPartition

protected boolean hasPartition ( ITestDevice device, 
                String partition)

Vérifie avec le chargeur de démarrage si la partition spécifiée existe ou non

Paramètres
device ITestDevice : l' ITestDevice sur ITestDevice opérer

partition String : le nom de la partition à vérifier

Retour
boolean

Jette
DeviceNotAvailableException

preFlashSetup

protected void preFlashSetup ( ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Effectuez toute configuration de pré-clignotement supplémentaire requise. No-op sauf si remplacé.

Paramètres
device ITestDevice : l' ITestDevice à préparer

deviceBuild IDeviceBuildInfo : l' IDeviceBuildInfo contenant les fichiers de construction

Jette
com.android.tradefed.device.DeviceNotAvailableException
TargetSetupError
DeviceNotAvailableException

verifyRequiredBoards

protected void verifyRequiredBoards ( ITestDevice device, 
                IFlashingResourcesParser resourceParser, 
                String deviceProductType)

Vérifiez que le type de produit du périphérique prend en charge la version à flash.

L'implémentation de base vérifiera que le deviceProductType est inclus dans la collection IFlashingResourcesParser#getRequiredBoards() . Les sous-classes peuvent être remplacées à volonté.

Paramètres
device ITestDevice : l' ITestDevice à flasher

resourceParser IFlashingResourcesParser : le IFlashingResourcesParser

deviceProductType String : le type de produit de l' device

Jette
TargetSetupError si les informations de carte requises pour la construction ne correspondent pas à l'appareil

wipeCache

protected void wipeCache ( ITestDevice device)

Essuyez la partition de cache sur l'appareil.

Paramètres
device ITestDevice : l' ITestDevice à flasher

Jette
DeviceNotAvailableException si l'appareil n'est pas disponible
TargetSetupError en cas d'échec du cache flash

wipePartition

protected void wipePartition ( ITestDevice device, 
                String partition)

Nettoyez la partition spécifiée avec `fastboot erase <nom>`

Paramètres
device ITestDevice : l' ITestDevice sur ITestDevice opérer

partition String : le nom de la partition à effacer

Jette
DeviceNotAvailableException
TargetSetupError