FastbootDeviceFlasher
public
class
FastbootDeviceFlasher
extends Object
implements
IDeviceFlasher
| java.lang.Object | |
| ↳ | com.android.tradefed.targetprep.FastbootDeviceFlasher |
Classe qui s'appuie sur fastboot pour flasher une image sur un matériel Android physique.
Résumé
Constantes | |
|---|---|
String |
BASEBAND_IMAGE_NAME
|
Constructeurs publics | |
|---|---|
FastbootDeviceFlasher()
|
|
Méthodes publiques | |
|---|---|
static
String
|
fetchImageVersion(IRunUtil runUtil, ITestDevice device, String imageName)
Méthode d'assistance permettant d'obtenir la version actuelle de l'image sur l'appareil. |
void
|
flash(ITestDevice device, IDeviceBuildInfo deviceBuild)
Flashe le build sur l'appareil. |
CommandStatus
|
getSystemFlashingStatus()
Récupérez l'état d'exécution de la commande pour flasher les partitions système principales. |
IDeviceFlasher.UserDataFlashOption
|
getUserDataFlashOption()
Indique si l'image des données utilisateur doit être flashée, effacée ou conservée. |
void
|
overrideDeviceOptions(ITestDevice device)
Options de remplacement pour un appareil. |
void
|
preFlashOperations(ITestDevice device, IDeviceBuildInfo deviceBuild)
Toutes les opérations et vérifications de configuration qui doivent avoir lieu avant la section critique du flashage proprement dit. |
void
|
setDataWipeSkipList(
Définit la liste des chemins d'accès sous
Notez que la précision de la liste de désactivation correspond aux enfants directs de |
void
|
setFlashOptions(
Définit une liste d'options à transmettre avec les commandes flash/update. |
void
|
setFlashingResourcesRetriever(IFlashingResourcesRetriever retriever)
Définit le mécanisme par lequel le programme de flashage peut récupérer les fichiers de ressources à flasher. |
void
|
setForceSystemFlash(boolean forceSystemFlash)
Indique si le système doit toujours être flashé, même s'il exécute la version actuelle. |
void
|
setIncrementalFlashing(IncrementalImageUtil incrementalUtil)
|
void
|
setRamdiskPartition(String ramdiskPartition)
Définit la partition ramdisk |
void
|
setShouldFlashRamdisk(boolean shouldFlashRamdisk)
Indique si un ramdisk supplémentaire doit être installé après la mise à jour de l'appareil via le fichier ZIP de l'image. |
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 avant l'effacement des données. |
boolean
|
shouldFlashRamdisk()
Vérifie si le programme de flashage est configuré pour qu'un ramdisk supplémentaire soit flashé après la mise à jour de l'appareil via le fichier ZIP de l'image |
boolean
|
shouldSkipBootloaderVersionCheck()
|
static
boolean
|
stderrContainsFailed(String stderr, boolean skipBootloaderVersionCheck)
|
static
boolean
|
stderrContainsFailed(String stderr, boolean skipBootloaderVersionCheck, boolean skipFastbootFailedMessage)
|
Méthodes protégées | |
|---|---|
void
|
checkAndFlashBaseband(ITestDevice device, IDeviceBuildInfo deviceBuild)
Si nécessaire, flashez l'image de bande de base sur l'appareil. |
boolean
|
checkAndFlashBootloader(ITestDevice device, IDeviceBuildInfo deviceBuild)
Si nécessaire, flashez l'image du bootloader 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 de fabrique permettant de créer un |
void
|
downloadExtraImageFiles(IFlashingResourcesParser resourceParser, IFlashingResourcesRetriever retriever, IDeviceBuildInfo localBuild)
Accroche permettant aux sous-classes de télécharger des fichiers d'images personnalisées supplémentaires si nécessaire. |
void
|
downloadFlashingResources(ITestDevice device, IDeviceBuildInfo localBuild)
Télécharge les fichiers image de flashage 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. |
String
|
executeLongFastbootCmd(ITestDevice device,
Méthode d'assistance pour exécuter une commande fastboot de longue durée avec des variables d'environnement. |
void
|
flashBaseband(ITestDevice device, File basebandImageFile)
Flashe l'image de bande de base donnée et redémarre dans le bootloader |
void
|
flashBootloader(ITestDevice device, File bootloaderImageFile)
Flashe l'image du bootloader donnée et redémarre dans le bootloader |
void
|
flashExtraImages(ITestDevice device, IDeviceBuildInfo deviceBuild)
Flashez les partitions spécifiques à l'appareil avant de flasher le système et de redémarrer. |
void
|
flashPartition(ITestDevice device, File imgFile, String partition)
Flasher une partition individuelle d'un appareil |
void
|
flashRamdiskIfNeeded(ITestDevice device, IDeviceBuildInfo deviceBuild)
|
void
|
flashSystem(ITestDevice device, IDeviceBuildInfo deviceBuild)
Flashez l'image système sur l'appareil. |
void
|
flashUserData(ITestDevice device, IDeviceBuildInfo deviceBuild)
Flashez la partition des données utilisateur sur l'appareil. |
void
|
flashUserDataFromDeviceImageFile(ITestDevice device, IDeviceBuildInfo deviceBuild)
Extrait le fichier userdata.img du fichier image de l'appareil et le transfère sur l'appareil |
String
|
getBootPartitionName()
Obtenez le nom de la partition de démarrage pour ce programme de flashage d'appareil. |
String
|
getBootloaderFilePrefix(ITestDevice device)
Obtenez le préfixe du fichier bootloader. |
String
|
getCurrentSlot(ITestDevice device)
Méthode d'assistance permettant de récupérer l'emplacement actuel (pour les appareils compatibles avec les tests A/B). |
IFlashingResourcesRetriever
|
getFlashingResourcesRetriever()
|
FuseUtil
|
getFuseUtil()
|
String
|
getImageVersion(ITestDevice device, String imageName)
|
IRunUtil
|
getRunUtil()
Exposé pour les tests. |
void
|
handleUserDataFlashing(ITestDevice device, IDeviceBuildInfo deviceBuild)
Gérer le flashage de la partition userdata/cache |
boolean
|
hasPartition(ITestDevice device, String partition)
Vérifie auprès du bootloader si la partition spécifiée existe ou non |
void
|
preFlashSetup(ITestDevice device, IDeviceBuildInfo deviceBuild)
Effectuez toute configuration supplémentaire requise avant le flashage. |
void
|
setSkipBootloaderVersionCheck(boolean skipBootloaderVersionCheck)
|
void
|
setSkipFastbootFailedMessage(boolean skipFastbootFailedMessage)
|
void
|
setSystemBuildInfo(String systemBuildId, String systemBuildFlavor)
|
void
|
verifyRequiredBoards(ITestDevice device, IFlashingResourcesParser resourceParser, String deviceProductType)
Vérifiez que le type de produit de l'appareil est compatible avec la version à flasher. |
void
|
wipeCache(ITestDevice device)
Effacez la partition de cache sur l'appareil. |
void
|
wipePartition(ITestDevice device, String partition)
Effacez la partition spécifiée avec `fastboot erase <name>`. |
Constantes
BASEBAND_IMAGE_NAME
public static final String BASEBAND_IMAGE_NAME
Valeur constante : "radio"
Constructeurs publics
FastbootDeviceFlasher
public FastbootDeviceFlasher ()
Méthodes publiques
fetchImageVersion
public static String fetchImageVersion (IRunUtil runUtil, ITestDevice device, String imageName)
Méthode d'assistance permettant d'obtenir la version actuelle de l'image sur l'appareil.
| Paramètres | |
|---|---|
runUtil |
IRunUtil |
device |
ITestDevice : ITestDevice sur lequel exécuter la commande |
imageName |
String : nom de l'image à obtenir. |
| Renvoie | |
|---|---|
String |
Chaîne de sortie stdout de la commande |
| Génère | |
|---|---|
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. |
flash
public void flash (ITestDevice device, IDeviceBuildInfo deviceBuild)
Flashe le build sur l'appareil.
Renvoie immédiatement une valeur une fois le flashage terminé. Les appelants doivent attendre que l'appareil soit en ligne et disponible avant de procéder aux tests.
| Paramètres | |
|---|---|
device |
ITestDevice : ITestDevice à mettre en surbrillance |
deviceBuild |
IDeviceBuildInfo : IDeviceBuildInfo à mettre en surbrillance |
| Génère | |
|---|---|
DeviceNotAvailableException |
|
TargetSetupError |
|
getSystemFlashingStatus
public CommandStatus getSystemFlashingStatus ()
Récupérez l'état d'exécution de la commande pour flasher les partitions système principales.
Notez que si les partitions système ne sont pas flashées (le système possède déjà la version à flasher), l'état de la commande peut être null.
| Renvoie | |
|---|---|
CommandStatus |
|
getUserDataFlashOption
public IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()
Indique si l'image des données utilisateur doit être flashée, effacée ou conservée.
| Renvoie | |
|---|---|
IDeviceFlasher.UserDataFlashOption |
Indique si l'image des données utilisateur doit être flashée, effacée ou conservée. |
overrideDeviceOptions
public void overrideDeviceOptions (ITestDevice device)
Options de remplacement pour un appareil. Permet de remplacer les valeurs d'option par défaut si elles ne sont pas compatibles avec un appareil spécifique.
preFlashOperations
public void preFlashOperations (ITestDevice device, IDeviceBuildInfo deviceBuild)
Toutes les opérations et vérifications de configuration qui doivent avoir lieu avant la section critique du flashage proprement dit. Aucune de ces opérations ne sera incluse dans la section critique contrôlée par la concurrence.
| Paramètres | |
|---|---|
device |
ITestDevice : ITestDevice à mettre en surbrillance |
deviceBuild |
IDeviceBuildInfo : IDeviceBuildInfo à mettre en surbrillance |
| Génère | |
|---|---|
DeviceNotAvailableException |
|
TargetSetupError |
|
setDataWipeSkipList
public void setDataWipeSkipList (dataWipeSkipList)
Définit la liste des chemins d'accès sous /data à ne pas effacer lors de l'utilisation de ITestsZipInstaller.
Notez que la précision de la liste de désactivation correspond aux 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 programme de flashage peut récupérer les fichiers de ressources à flasher.
| Paramètres | |
|---|---|
retriever |
IFlashingResourcesRetriever : IFlashingResourcesRetriever à utiliser |
setForceSystemFlash
public void setForceSystemFlash (boolean forceSystemFlash)
Indique si le système doit toujours être flashé, même s'il exécute la version actuelle.
setIncrementalFlashing
public void setIncrementalFlashing (IncrementalImageUtil incrementalUtil)
| Paramètres | |
|---|---|
incrementalUtil |
IncrementalImageUtil |
setRamdiskPartition
public void setRamdiskPartition (String ramdiskPartition)
Définit la partition ramdisk
setShouldFlashRamdisk
public void setShouldFlashRamdisk (boolean shouldFlashRamdisk)
Indique si un ramdisk supplémentaire doit être installé après la mise à jour de l'appareil via le fichier ZIP de l'image.
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 avant l'effacement des données.
| Paramètres | |
|---|---|
timeout |
long |
shouldFlashRamdisk
public boolean shouldFlashRamdisk ()
Vérifie si le programme de flashage est configuré pour qu'un ramdisk supplémentaire soit flashé après la mise à jour de l'appareil via le fichier ZIP de l'image
| Renvoie | |
|---|---|
boolean |
|
shouldSkipBootloaderVersionCheck
public boolean shouldSkipBootloaderVersionCheck ()
| Renvoie | |
|---|---|
boolean |
|
stderrContainsFailed
public static boolean stderrContainsFailed (String stderr,
boolean skipBootloaderVersionCheck)| Paramètres | |
|---|---|
stderr |
String |
skipBootloaderVersionCheck |
boolean |
| Renvoie | |
|---|---|
boolean |
|
stderrContainsFailed
public static boolean stderrContainsFailed (String stderr,
boolean skipBootloaderVersionCheck,
boolean skipFastbootFailedMessage)| Paramètres | |
|---|---|
stderr |
String |
skipBootloaderVersionCheck |
boolean |
skipFastbootFailedMessage |
boolean |
| Renvoie | |
|---|---|
boolean |
|
Méthodes protégées
checkAndFlashBaseband
protected void checkAndFlashBaseband (ITestDevice device, IDeviceBuildInfo deviceBuild)
Si nécessaire, flashez l'image de bande de base sur l'appareil. La bande de base ne sera flashée que si la version actuelle sur l'appareil est différente de la version requise.
| Paramètres | |
|---|---|
device |
ITestDevice : ITestDevice à mettre en surbrillance |
deviceBuild |
IDeviceBuildInfo : IDeviceBuildInfo contenant l'image de bande de base à flasher |
| Génère | |
|---|---|
DeviceNotAvailableException |
si l'appareil n'est pas disponible. |
TargetSetupError |
en cas d'échec du flashage de la bande de base. |
checkAndFlashBootloader
protected boolean checkAndFlashBootloader (ITestDevice device, IDeviceBuildInfo deviceBuild)
Si nécessaire, flashez l'image du bootloader sur l'appareil.
Le bootloader ne sera flashé que si la version actuelle sur l'appareil est différente de la version requise.
| Paramètres | |
|---|---|
device |
ITestDevice : ITestDevice à mettre en surbrillance |
deviceBuild |
IDeviceBuildInfo : IDeviceBuildInfo contenant l'image du bootloader à flasher |
| Renvoie | |
|---|---|
boolean |
true si le bootloader a été installé, false s'il a été ignoré |
| Génère | |
|---|---|
DeviceNotAvailableException |
si l'appareil n'est pas disponible. |
TargetSetupError |
en cas d'échec du flashage du bootloader. |
checkAndFlashSystem
protected boolean checkAndFlashSystem (ITestDevice device, String systemBuildId, String systemBuildFlavor, IDeviceBuildInfo deviceBuild)
Si nécessaire, flashez l'image système sur l'appareil.
Veuillez consulter ERROR(/#shouldFlashSystem(String,String,com.android.tradefed.build.IDeviceBuildInfo)).
Quel que soit le chemin choisi, l'appareil doit démarrer dans l'espace utilisateur après l'exécution de la méthode.
| Paramètres | |
|---|---|
device |
ITestDevice : ITestDevice à mettre en surbrillance |
systemBuildId |
String : ID de compilation actuel exécuté sur l'appareil |
systemBuildFlavor |
String : variante de build actuelle exécutée sur l'appareil |
deviceBuild |
IDeviceBuildInfo : IDeviceBuildInfo contenant l'image système à flasher |
| Renvoie | |
|---|---|
boolean |
true si le système a été flashé, false s'il a été ignoré |
| Génère | |
|---|---|
DeviceNotAvailableException |
si l'appareil n'est pas disponible. |
TargetSetupError |
en cas d'échec du flashage du bootloader. |
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 : ITestDevice à vérifier |
deviceBuild |
IDeviceBuildInfo : IDeviceBuildInfo contenant l'image de bande de base à vérifier. |
| Renvoie | |
|---|---|
boolean |
|
| Génère | |
|---|---|
DeviceNotAvailableException |
si l'appareil n'est pas disponible. |
TargetSetupError |
en cas d'échec du flashage de la bande de base. |
createFlashingResourcesParser
protected IFlashingResourcesParser createFlashingResourcesParser (IDeviceBuildInfo localBuild, DeviceDescriptor descriptor)
Méthode de fabrique permettant de créer un IFlashingResourcesParser.
Exposé pour les tests unitaires.
| Paramètres | |
|---|---|
localBuild |
IDeviceBuildInfo : IDeviceBuildInfo à analyser |
descriptor |
DeviceDescriptor : descripteur de l'appareil en cours de flashage. |
| Renvoie | |
|---|---|
IFlashingResourcesParser |
un IFlashingResourcesParser créé par la méthode de fabrique. |
| Génère | |
|---|---|
|
com.android.tradefed.targetprep.TargetSetupError |
TargetSetupError |
|
downloadExtraImageFiles
protected void downloadExtraImageFiles (IFlashingResourcesParser resourceParser, IFlashingResourcesRetriever retriever, IDeviceBuildInfo localBuild)
Accroche permettant aux sous-classes de télécharger des fichiers d'images personnalisées supplémentaires si nécessaire.
| Paramètres | |
|---|---|
resourceParser |
IFlashingResourcesParser : IFlashingResourcesParser |
retriever |
IFlashingResourcesRetriever : IFlashingResourcesRetriever |
localBuild |
IDeviceBuildInfo : IDeviceBuildInfo |
| Génère | |
|---|---|
|
com.android.tradefed.targetprep.TargetSetupError |
TargetSetupError |
|
downloadFlashingResources
protected void downloadFlashingResources (ITestDevice device, IDeviceBuildInfo localBuild)
Télécharge les fichiers image de flashage supplémentaires nécessaires
| Paramètres | |
|---|---|
device |
ITestDevice : ITestDevice pour lequel télécharger les ressources |
localBuild |
IDeviceBuildInfo : IDeviceBuildInfo à renseigner. Suppose que le fichier image de l'appareil est déjà défini |
| Génère | |
|---|---|
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 : ITestDevice sur lequel exécuter la commande |
cmdArgs |
String : arguments à fournir à fastboot |
| Renvoie | |
|---|---|
String |
Chaîne la sortie stderr de la commande si elle n'est pas vide. Sinon, renvoie stdout. Certaines commandes fastboot sont étranges, car elles vident la sortie dans stderr en cas de réussite. |
| Génère | |
|---|---|
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 fastboot s'exécutent normalement dans le délai d'expiration autorisé par INativeDevice.executeFastbootCommand(String). Toutefois, lorsque plusieurs appareils sont flashés en même temps, les commandes fastboot peuvent prendre beaucoup plus de temps que d'habitude.
| Paramètres | |
|---|---|
device |
ITestDevice : ITestDevice sur lequel exécuter la commande |
cmdArgs |
String : arguments à fournir à fastboot |
| Renvoie | |
|---|---|
String |
Chaîne la sortie stderr de la commande si elle n'est pas vide. Sinon, renvoie stdout. Certaines commandes fastboot sont étranges, car elles vident la sortie dans stderr en cas de réussite. |
| Génère | |
|---|---|
DeviceNotAvailableException |
si l'appareil n'est pas disponible. |
TargetSetupError |
Si la commande fastboot échoue |
executeLongFastbootCmd
protected String executeLongFastbootCmd (ITestDevice device,envVarMap, String... cmdArgs)
Méthode d'assistance pour exécuter une commande fastboot de longue durée avec des variables d'environnement.
Remarque : La plupart des commandes fastboot s'exécutent normalement dans le délai d'expiration autorisé par INativeDevice.executeFastbootCommand(String). Toutefois, lorsque plusieurs appareils sont flashés en même temps, les commandes fastboot peuvent prendre beaucoup plus de temps que d'habitude.
| Paramètres | |
|---|---|
device |
ITestDevice : ITestDevice sur lequel exécuter la commande |
envVarMap |
: carte contenant les variables d'environnement à définir avant d'exécuter la commande fastboot |
cmdArgs |
String : arguments à fournir à fastboot |
| Renvoie | |
|---|---|
String |
Chaîne la sortie stderr de la commande si elle n'est pas vide. Sinon, renvoie stdout. Certaines commandes fastboot sont étranges, car elles vident la sortie dans stderr en cas de réussite. |
| Génère | |
|---|---|
DeviceNotAvailableException |
si l'appareil n'est pas disponible. |
TargetSetupError |
Si la commande fastboot échoue |
flashBaseband
protected void flashBaseband (ITestDevice device, File basebandImageFile)
Flashe l'image de bande de base donnée et redémarre dans le bootloader
| Paramètres | |
|---|---|
device |
ITestDevice : ITestDevice à mettre en surbrillance |
basebandImageFile |
File : image de bande de base ERROR(/File) |
| Génère | |
|---|---|
DeviceNotAvailableException |
si l'appareil n'est pas disponible. |
TargetSetupError |
en cas d'échec du flashage de la bande de base. |
flashBootloader
protected void flashBootloader (ITestDevice device, File bootloaderImageFile)
Flashe l'image du bootloader donnée et redémarre dans le bootloader
| Paramètres | |
|---|---|
device |
ITestDevice : ITestDevice à mettre en surbrillance |
bootloaderImageFile |
File : image du bootloader ERROR(/File) |
| Génère | |
|---|---|
DeviceNotAvailableException |
si l'appareil n'est pas disponible. |
TargetSetupError |
en cas d'échec du flashage. |
flashExtraImages
protected void flashExtraImages (ITestDevice device, IDeviceBuildInfo deviceBuild)
Flashez les partitions spécifiques à l'appareil avant de flasher le système et de redémarrer. Aucune opération, sauf si elle est remplacée.
| Paramètres | |
|---|---|
device |
ITestDevice : ITestDevice à mettre en surbrillance |
deviceBuild |
IDeviceBuildInfo : IDeviceBuildInfo contenant les fichiers de compilation |
| Génère | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
|
com.android.tradefed.targetprep.TargetSetupError |
DeviceNotAvailableException |
|
TargetSetupError |
|
flashPartition
protected void flashPartition (ITestDevice device, File imgFile, String partition)
Flasher une partition individuelle d'un appareil
| Paramètres | |
|---|---|
device |
ITestDevice : ITestDevice à mettre en surbrillance |
imgFile |
File : ERROR(/File) pointant vers l'image à flasher. |
partition |
String : nom de la partition à flasher |
| Génère | |
|---|---|
DeviceNotAvailableException |
|
TargetSetupError |
|
flashRamdiskIfNeeded
protected void flashRamdiskIfNeeded (ITestDevice device, IDeviceBuildInfo deviceBuild)
| Paramètres | |
|---|---|
device |
ITestDevice |
deviceBuild |
IDeviceBuildInfo |
| Génère | |
|---|---|
DeviceNotAvailableException |
|
TargetSetupError |
|
flashSystem
protected void flashSystem (ITestDevice device, IDeviceBuildInfo deviceBuild)
Flashez l'image système sur l'appareil.
| Paramètres | |
|---|---|
device |
ITestDevice : ITestDevice à mettre en surbrillance |
deviceBuild |
IDeviceBuildInfo : IDeviceBuildInfo à mettre en surbrillance |
| Génère | |
|---|---|
DeviceNotAvailableException |
si l'appareil n'est pas disponible. |
TargetSetupError |
Si la commande fastboot échoue |
flashUserData
protected void flashUserData (ITestDevice device, IDeviceBuildInfo deviceBuild)
Flashez la partition des données utilisateur sur l'appareil.
| Paramètres | |
|---|---|
device |
ITestDevice : ITestDevice à mettre en surbrillance |
deviceBuild |
IDeviceBuildInfo : IDeviceBuildInfo contenant les fichiers à flasher |
| Génère | |
|---|---|
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 fichier userdata.img du fichier image de l'appareil et le transfère sur l'appareil
| Paramètres | |
|---|---|
device |
ITestDevice : ITestDevice à mettre en surbrillance |
deviceBuild |
IDeviceBuildInfo : IDeviceBuildInfo contenant les fichiers à flasher |
| Génère | |
|---|---|
DeviceNotAvailableException |
si l'appareil n'est pas disponible. |
TargetSetupError |
en cas d'échec de l'extraction ou du flashage des données utilisateur ; |
getBootPartitionName
protected String getBootPartitionName ()
Obtenez le nom de la partition de démarrage pour ce programme de flashage d'appareil.
La valeur par défaut est "bootloader". Les sous-classes doivent remplacer cette méthode si nécessaire.
| Renvoie | |
|---|---|
String |
|
getBootloaderFilePrefix
protected String getBootloaderFilePrefix (ITestDevice device)
Obtenez le préfixe du fichier bootloader.
La valeur par défaut est getBootPartitionName(). Les sous-classes doivent remplacer cette méthode si nécessaire.
| Paramètres | |
|---|---|
device |
ITestDevice : ITestDevice à mettre en surbrillance |
| Renvoie | |
|---|---|
String |
|
| Génère | |
|---|---|
DeviceNotAvailableException |
si l'appareil n'est pas disponible. |
TargetSetupError |
en cas d'échec de l'obtention du préfixe |
getCurrentSlot
protected String getCurrentSlot (ITestDevice device)
Méthode d'assistance permettant de récupérer l'emplacement actuel (pour les appareils compatibles avec les tests A/B).
| Paramètres | |
|---|---|
device |
ITestDevice : ITestDevice sur lequel exécuter la commande. |
| Renvoie | |
|---|---|
String |
"a", "b" ou null (si l'appareil n'est pas compatible avec les mises à jour A/B) |
| Génère | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
|
com.android.tradefed.targetprep.TargetSetupError |
DeviceNotAvailableException |
|
TargetSetupError |
|
getFlashingResourcesRetriever
protected IFlashingResourcesRetriever getFlashingResourcesRetriever ()
| Renvoie | |
|---|---|
IFlashingResourcesRetriever |
|
getImageVersion
protected String getImageVersion (ITestDevice device, String imageName)
| Paramètres | |
|---|---|
device |
ITestDevice |
imageName |
String |
| Renvoie | |
|---|---|
String |
|
| Génère | |
|---|---|
DeviceNotAvailableException |
|
TargetSetupError |
|
handleUserDataFlashing
protected void handleUserDataFlashing (ITestDevice device, IDeviceBuildInfo deviceBuild)
Gérer le flashage de la partition userdata/cache
| Paramètres | |
|---|---|
device |
ITestDevice : ITestDevice à mettre en surbrillance |
deviceBuild |
IDeviceBuildInfo : IDeviceBuildInfo contenant les fichiers à flasher |
| Génère | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
|
com.android.tradefed.targetprep.TargetSetupError |
DeviceNotAvailableException |
|
TargetSetupError |
|
hasPartition
protected boolean hasPartition (ITestDevice device, String partition)
Vérifie auprès du bootloader si la partition spécifiée existe ou non
| Paramètres | |
|---|---|
device |
ITestDevice : ITestDevice sur lequel effectuer des opérations |
partition |
String : nom de la partition à vérifier |
| Renvoie | |
|---|---|
boolean |
|
| Génère | |
|---|---|
DeviceNotAvailableException |
|
preFlashSetup
protected void preFlashSetup (ITestDevice device, IDeviceBuildInfo deviceBuild)
Effectuez toute configuration supplémentaire requise avant le flashage. Aucune opération, sauf si elle est remplacée.
| Paramètres | |
|---|---|
device |
ITestDevice : ITestDevice à préparer |
deviceBuild |
IDeviceBuildInfo : IDeviceBuildInfo contenant les fichiers de compilation |
| Génère | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
|
com.android.tradefed.targetprep.TargetSetupError |
DeviceNotAvailableException |
|
TargetSetupError |
|
setSkipBootloaderVersionCheck
protected void setSkipBootloaderVersionCheck (boolean skipBootloaderVersionCheck)
| Paramètres | |
|---|---|
skipBootloaderVersionCheck |
boolean |
setSkipFastbootFailedMessage
protected void setSkipFastbootFailedMessage (boolean skipFastbootFailedMessage)
| Paramètres | |
|---|---|
skipFastbootFailedMessage |
boolean |
setSystemBuildInfo
protected void setSystemBuildInfo (String systemBuildId,
String systemBuildFlavor)| Paramètres | |
|---|---|
systemBuildId |
String |
systemBuildFlavor |
String |
verifyRequiredBoards
protected void verifyRequiredBoards (ITestDevice device, IFlashingResourcesParser resourceParser, String deviceProductType)
Vérifiez que le type de produit de l'appareil est compatible avec la version à flasher.
L'implémentation de base vérifiera que deviceProductType est inclus dans la collection IFlashingResourcesParser.getRequiredBoards(). Les sous-classes peuvent remplacer les valeurs par défaut si elles le souhaitent.
| Paramètres | |
|---|---|
device |
ITestDevice : ITestDevice à flasher |
resourceParser |
IFlashingResourcesParser : IFlashingResourcesParser |
deviceProductType |
String : type de produit de device |
| Génère | |
|---|---|
TargetSetupError |
si les informations requises sur la carte de compilation ne correspondent pas à l'appareil. |
wipeCache
protected void wipeCache (ITestDevice device)
Effacez la partition de cache sur l'appareil.
| Paramètres | |
|---|---|
device |
ITestDevice : ITestDevice à mettre en surbrillance |
| Génère | |
|---|---|
DeviceNotAvailableException |
si l'appareil n'est pas disponible. |
TargetSetupError |
en cas d'échec du vidage du cache. |
wipePartition
protected void wipePartition (ITestDevice device, String partition)
Effacez la partition spécifiée avec `fastboot erase <name>`.
| Paramètres | |
|---|---|
device |
ITestDevice : ITestDevice sur lequel effectuer des opérations |
partition |
String : nom de la partition à effacer |
| Génère | |
|---|---|
DeviceNotAvailableException |
|
TargetSetupError |
|