IDeviceFlasher

public interface IDeviceFlasher

com.android.tradefed.targetprep.IDeviceFlasher


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 obtenir des artefacts de compilation supplémentaires.

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

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

abstract void overrideDeviceOptions(ITestDevice device)

Ignorer les options pour un appareil

default void postFlashOperations(ITestDevice device, IDeviceBuildInfo deviceBuild)

Toutes les opérations de nettoyage et toutes les vérifications qui doivent avoir lieu après le flashage de la section critique.

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 pour le flashage.

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 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 d'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 flasher peut être flashé en mode fastbootd.

Méthodes publiques

flash

public abstract void flash (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Les fichiers Flash se compilent sur l'appareil.

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

Paramètres
device ITestDevice : ITestDevice à flasher

deviceBuild IDeviceBuildInfo: IDeviceBuildInfo à flasher

Génère
TargetSetupError si l'échec du flashage du build
DeviceNotAvailableException si l'appareil ne répond plus

getAdditionalFileFilters

public  getAdditionalFileFilters ()

Obtenez des filtres pour obtenir des artefacts de compilation supplémentaires.

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 modèles de fichier, et tous les fichiers correspondant à ce modèle seront 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 possède déjà le build à flasher), l'état de la commande peut être null.

Renvoie
CommandStatus

getUserDataFlashOption

public abstract IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

Détermine 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

remplacer les options de l'appareil

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 toutes les vérifications qui doivent avoir lieu après le flashage de la section critique. Aucune de ces opérations ne sera incluse dans la section critique avec contrôle de simultanéité.

Paramètres
device ITestDevice: ITestDevice à flasher

deviceBuild IDeviceBuildInfo: IDeviceBuildInfo à flasher

Génère
TargetSetupError en cas d'échec d'une configuration
DeviceNotAvailableException si l'appareil ne répond plus

Opérations preFlash

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 avec contrôle de simultanéité.

Paramètres
device ITestDevice : ITestDevice à flasher

deviceBuild IDeviceBuildInfo : IDeviceBuildInfo à flasher

Génère
TargetSetupError en cas d'échec d'une configuration
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 précision de la liste à ignorer 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 les fichiers de ressources à flasher.

Paramètres
retriever IFlashingResourcesRetriever : IFlashingResourcesRetriever à utiliser

setForceSystemFlash

public abstract void setForceSystemFlash (boolean forceSystemFlash)

Détermine 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.

setClearTimeout

public abstract void setWipeTimeout (long timeout)

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

Paramètres
timeout long

doitFlashRamdisk

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