IDeviceFlasher

public interface IDeviceFlasher

com.android.tradefed.targetprep.IDeviceFlasher

Sous-classes indirectes connues CdmaDeviceFlasher, FastbootDeviceFlasher, OtaUpdateDeviceFlasher, SystemUpdaterDeviceFlasher CdmaDeviceFlasher Classe qui flashe une image sur un appareil Android physique avec une radio CDMA.  FastbootDeviceFlasher Classe qui s'appuie sur fastboot pour flasher une image sur du matériel Android physique.  OtaUpdateDeviceFlasher Un flasheur d'appareil qui déclenche le script system/update_engine/scripts/update_device.py avec un package OTA complet ou incrémentiel pour mettre à jour l'image de l'appareil.  SystemUpdaterDeviceFlasher IDeviceFlasher qui s'appuie sur le programme de mise à jour du système pour installer une image système groupée dans un package de mise à jour OTA.

---

Flashe une image d'appareil sur un appareil.

Résumé

Méthodes publiques
abstract void	flash(ITestDevice device, IDeviceBuildInfo deviceBuild) Flashe le build sur l'appareil.
default	getAdditionalFileFilters() Obtenez des filtres pour d'autres artefacts de compilation.
abstract CommandStatus	getSystemFlashingStatus() Récupérez l'état d'exécution de la commande pour flasher les partitions système principales.
abstract IDeviceFlasher.UserDataFlashOption	getUserDataFlashOption() Indique si l'image des données utilisateur doit être flashée, effacée ou conservée
abstract void	overrideDeviceOptions(ITestDevice device) Options de forçage pour un appareil.
default void	postFlashOperations(ITestDevice device, IDeviceBuildInfo deviceBuild) Toutes les opérations de nettoyage et les vérifications qui doivent être effectuées après la section critique de flashage
default void	preFlashOperations(ITestDevice device, IDeviceBuildInfo deviceBuild) Toutes les opérations et vérifications de configuration qui doivent être effectuées avant la section critique de flashage
abstract void	setDataWipeSkipList( dataWipeSkipList) Définit la liste des chemins sous /data pour éviter l'effacement lors de l'utilisation de ITestsZipInstaller. Notez que la granularité de la liste de suppression correspond aux enfants directs de /data.
abstract void	setFlashingResourcesRetriever(IFlashingResourcesRetriever retriever) Définit le mécanisme par lequel le flasheur peut récupérer des fichiers de ressources à flasher.
abstract void	setForceSystemFlash(boolean forceSystemFlash) Indique si le système doit toujours être flashé, même si le build actuel est en cours d'exécution.
default void	setRamdiskPartition(String ramdiskPartition) Définit la partition de ramdisk
default void	setShouldFlashRamdisk(boolean shouldFlashRamdisk) Indique si un ramdisk supplémentaire doit être flashé après la mise à jour de l'appareil via un fichier ZIP d'image
abstract void	setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption) Indique si l'image des données utilisateur doit être flashée, effacée ou conservée
abstract void	setWipeTimeout(long timeout) Définissez le délai avant effacement des données.
default boolean	shouldFlashRamdisk() Vérifie si le flasheur est configuré pour qu'un ramdisk supplémentaire soit flashé après la mise à jour de l'appareil via un fichier ZIP d'image
default boolean	supportsFlashingInFastbootD() Indique si l'appareil qui implémente le flasheur peut être flashé en mode fastbootd.
default void	tearDownFlasher() Dernière opportunité pour l'implémentation du flasheur de nettoyer après lui-même

Méthodes publiques

flash

public abstract void flash (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Flashe le build sur l'appareil.

Renvoie immédiatement la 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 à flasher
deviceBuild	IDeviceBuildInfo: IDeviceBuildInfo à flasher

Génère
TargetSetupError	si la compilation du flash a échoué
DeviceNotAvailableException	Si l'appareil ne répond plus

getAdditionalFileFilters

public  getAdditionalFileFilters ()

Obtenez des filtres pour d'autres artefacts de compilation.

Certains flasheurs ont besoin de certains artefacts de compilation qui ne font pas partie des artefacts par défaut utilisés. Ces flasheurs doivent remplacer cette méthode afin que chaque utilisateur des outils de flashage n'ait pas besoin de connaître ces fichiers et de fournir des options de ligne de commande.

Notez que cette méthode est appelée sur une instance temporaire de l'IDeviceFlasher. Par conséquent, aucun état au-delà de celui fourni dans le constructeur par défaut ne doit être utilisé.

Les chaînes de l'ensemble sont interprétées comme des formats de fichiers, et tous les fichiers correspondant au format sont récupérés.

Par défaut, cette méthode renvoie un ensemble vide.

Renvoie

getSystemFlashingStatus

public abstract 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 dispose déjà du build à flasher), l'état de la commande peut être null.

Renvoie
CommandStatus

getUserDataFlashOption

public abstract 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 abstract void overrideDeviceOptions (ITestDevice device)

Options de forçage pour un appareil. Permet de remplacer les valeurs d'option par défaut si elles ne sont pas compatibles avec un appareil particulier.

postFlashOperations

public void postFlashOperations (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Toutes les opérations de nettoyage et les vérifications qui doivent être effectuées après la section critique de flashage Aucune de ces opérations ne sera incluse dans la section critique contrôlée par la concurrence.

Paramètres
device	ITestDevice: ITestDevice à flasher
deviceBuild	IDeviceBuildInfo: IDeviceBuildInfo à flasher

Génère
TargetSetupError	Si une configuration échoue
DeviceNotAvailableException	Si l'appareil ne répond plus

preFlashOperations

public void preFlashOperations (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Toutes les opérations et vérifications de configuration qui doivent être effectuées avant la section critique de flashage Aucune de ces opérations ne sera incluse dans la section critique contrôlée par la concurrence.

Paramètres
device	ITestDevice: ITestDevice à flasher
deviceBuild	IDeviceBuildInfo: IDeviceBuildInfo à flasher

Génère
TargetSetupError	Si une configuration échoue
DeviceNotAvailableException	Si l'appareil ne répond plus

setDataWipeSkipList

public abstract void setDataWipeSkipList ( dataWipeSkipList)

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

Notez que la granularité de la liste de suppression correspond aux enfants directs de /data.

Paramètres
dataWipeSkipList

setFlashingResourcesRetriever

public abstract void setFlashingResourcesRetriever (IFlashingResourcesRetriever retriever)

Définit le mécanisme par lequel le flasheur peut récupérer des fichiers de ressources à flasher.

Paramètres
retriever	IFlashingResourcesRetriever: IFlashingResourcesRetriever à utiliser

setForceSystemFlash

public abstract void setForceSystemFlash (boolean forceSystemFlash)

Indique si le système doit toujours être flashé, même si le build actuel est en cours d'exécution.

setRamdiskPartition

public void setRamdiskPartition (String ramdiskPartition)

Définit la partition de ramdisk

setShouldFlashRamdisk

public void setShouldFlashRamdisk (boolean shouldFlashRamdisk)

Indique si un ramdisk supplémentaire doit être flashé après la mise à jour de l'appareil via un fichier ZIP d'image

setUserDataFlashOption

public abstract void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

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

setWipeTimeout

public abstract void setWipeTimeout (long timeout)

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

Paramètres
timeout	long

shouldFlashRamdisk

public boolean shouldFlashRamdisk ()

Vérifie si le flasheur est configuré pour qu'un ramdisk supplémentaire soit flashé après la mise à jour de l'appareil via un fichier ZIP d'image

Renvoie
boolean

supportsFlashingInFastbootD

public boolean supportsFlashingInFastbootD ()

Indique si l'appareil qui implémente le flasheur peut être flashé en mode fastbootd.

Renvoie
boolean

tearDownFlasher

public void tearDownFlasher ()

Dernière opportunité pour l'implémentation du flasheur de nettoyer après lui-même