IDeviceFlasher

public interface IDeviceFlasher

com.android.tradefed.targetprep.IDeviceFlasher

Subcategorías indirectas conocidas CdmaDeviceFlasher, FastbootDeviceFlasher, OtaUpdateDeviceFlasher, SystemUpdaterDeviceFlasher CdmaDeviceFlasher Clase que muestra una imagen de forma intermitente en un dispositivo Android físico con una radio CDMA.  FastbootDeviceFlasher Clase que depende de fastboot para escribir una imagen en la memoria flash de hardware físico de Android.  OtaUpdateDeviceFlasher Es un dispositivo de escritura de memoria flash que activa el script system/update_engine/scripts/update_device.py con un paquete OTA completo o incremental para actualizar la imagen del dispositivo.  SystemUpdaterDeviceFlasher Un IDeviceFlasher que se basa en el actualizador del sistema para instalar una imagen del sistema incluida en un paquete de actualización inalámbrica.

---

Escribe una imagen de dispositivo en la memoria flash de un dispositivo.

Resumen

Métodos públicos
default boolean	checkAntiRollback(ITestDevice device, IDeviceBuildInfo deviceBuild) Verifica si se activó una reversión.
abstract void	flash(ITestDevice device, IDeviceBuildInfo deviceBuild) Escribe la compilación en la memoria flash del dispositivo.
default Set<String>	getAdditionalFileFilters() Obtiene filtros para artefactos de compilación adicionales.
abstract CommandStatus	getSystemFlashingStatus() Recupera el estado de ejecución del comando para escribir en las particiones del sistema principal.
abstract IDeviceFlasher.UserDataFlashOption	getUserDataFlashOption() Obtiene si se debe escribir, borrar o conservar la imagen de datos del usuario.
abstract void	overrideDeviceOptions(ITestDevice device) Son opciones de anulación para un dispositivo.
default void	postFlashOperations(ITestDevice device, IDeviceBuildInfo deviceBuild) Todas las operaciones y verificaciones de limpieza que deben ocurrir después de la escritura real de la sección crítica.
default void	preFlashOperations(ITestDevice device, IDeviceBuildInfo deviceBuild) Todas las operaciones y verificaciones de configuración que deben realizarse antes de la sección crítica de escritura real.
abstract void	setDataWipeSkipList(Collection<String> dataWipeSkipList) Establece la lista de rutas de acceso en /data que se deben evitar borrar cuando se usa ITestsZipInstaller. Ten en cuenta que la granularidad de la lista de omisión son los elementos secundarios directos de /data.
default void	setExtraMetadata(Map<String, String> metadata) Permite que el programador reciba opciones de metadatos adicionales.
abstract void	setFlashingResourcesRetriever(IFlashingResourcesRetriever retriever) Establece el mecanismo por el cual el programador puede recuperar archivos de recursos para la programación.
abstract void	setForceSystemFlash(boolean forceSystemFlash) Establece si el sistema siempre debe escribirse en la memoria flash, incluso si se ejecuta la compilación actual.
default void	setRamdiskPartition(String ramdiskPartition) Establece la partición de ramdisk
default void	setShouldFlashRamdisk(boolean shouldFlashRamdisk) Establece si se debe escribir un ramdisk adicional después de actualizar el dispositivo a través de un archivo zip de imagen.
abstract void	setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption) Alterna si la imagen de datos del usuario se debe escribir en la memoria flash, borrar o conservar.
abstract void	setWipeTimeout(long timeout) Establece el tiempo de espera para borrar los datos.
default boolean	shouldFlashRamdisk() Comprueba si el programador de memoria flash está configurado para que se escriba un disco RAM adicional después de actualizar el dispositivo a través de un archivo zip de imagen.
default boolean	supportsFlashingInFastbootD() Indica si se puede escribir en la memoria flash del dispositivo que implementa el flasher en modo fastbootd.
default void	tearDownFlasher() Última oportunidad para que la implementación del flasher libere espacio

Métodos públicos

checkAntiRollback

public boolean checkAntiRollback (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Verifica si se activó una reversión.

Parámetros
device	ITestDevice
deviceBuild	IDeviceBuildInfo

Muestra
boolean

Arroja
DeviceNotAvailableException

flash

public abstract void flash (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Escribe la compilación en la memoria flash del dispositivo.

Regresa inmediatamente después de que se completa el proceso de escritura en la memoria flash. Las personas que llaman deben esperar a que el dispositivo esté en línea y disponible antes de continuar con la prueba.

Parámetros
device	ITestDevice: el ITestDevice que se escribirá en la memoria flash
deviceBuild	IDeviceBuildInfo: el IDeviceBuildInfo que se escribirá en la memoria flash

Arroja
DeviceNotAvailableException	Si el dispositivo no responde
TargetSetupError	Si no se pudo escribir la compilación en la memoria flash

getAdditionalFileFilters

public Set<String> getAdditionalFileFilters ()

Obtiene filtros para artefactos de compilación adicionales.

Algunos flashers necesitan ciertos artefactos de compilación que no se encuentran entre los predeterminados que se usan. Los programadores de este tipo de herramientas deben anular este método para que todos los usuarios de las herramientas de escritura en la memoria flash no necesiten conocer estos archivos ni proporcionar opciones de línea de comandos.

Ten en cuenta que este método se invoca en una instancia temporal de IDeviceFlasher, por lo que no se debe confiar en ningún estado más allá del que se proporciona en el constructor predeterminado.

Las cadenas del conjunto se interpretan como patrones de archivos y se recuperarán todos los archivos que coincidan con el patrón.

De forma predeterminada, este método devuelve un conjunto vacío.

Muestra
Set<String>

getSystemFlashingStatus

public abstract CommandStatus getSystemFlashingStatus ()

Recupera el estado de ejecución del comando para escribir en las particiones del sistema principal.

Ten en cuenta que, si no se escriben las particiones del sistema (el sistema ya tiene la compilación que se escribirá), el estado del comando puede ser null.

Muestra
CommandStatus

getUserDataFlashOption

public abstract IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

Obtiene si se debe escribir, borrar o conservar la imagen de datos del usuario.

Muestra
IDeviceFlasher.UserDataFlashOption	Indica si se debe escribir, borrar o conservar la imagen de datos del usuario.

overrideDeviceOptions

public abstract void overrideDeviceOptions (ITestDevice device)

Son opciones de anulación para un dispositivo. Se usa para anular los valores de las opciones predeterminadas si un dispositivo en particular no admite los valores predeterminados.

postFlashOperations

public void postFlashOperations (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Todas las operaciones y verificaciones de limpieza que deben ocurrir después de la escritura real de la sección crítica. Ninguna de esas operaciones se incluirá en la sección crítica controlada por simultaneidad.

Parámetros
device	ITestDevice: el ITestDevice que se escribirá en la memoria flash
deviceBuild	IDeviceBuildInfo: el IDeviceBuildInfo que se escribirá en la memoria flash

Arroja
DeviceNotAvailableException	Si el dispositivo no responde
TargetSetupError	Si falla alguna configuración

preFlashOperations

public void preFlashOperations (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Todas las operaciones y verificaciones de configuración que deben realizarse antes de la sección crítica de escritura real. Ninguna de esas operaciones se incluirá en la sección crítica controlada por simultaneidad.

Parámetros
device	ITestDevice: el ITestDevice que se escribirá en la memoria flash
deviceBuild	IDeviceBuildInfo: el IDeviceBuildInfo que se escribirá en la memoria flash

Arroja
DeviceNotAvailableException	Si el dispositivo no responde
TargetSetupError	Si falla alguna configuración

setDataWipeSkipList

public abstract void setDataWipeSkipList (Collection<String> dataWipeSkipList)

Establece la lista de rutas de acceso en /data que se deben evitar borrar cuando se usa ITestsZipInstaller.

Ten en cuenta que la granularidad de la lista de omisión son los elementos secundarios directos de /data.

Parámetros
dataWipeSkipList	Collection

setExtraMetadata

public void setExtraMetadata (Map<String, String> metadata)

Permite que el programador reciba opciones de metadatos adicionales.

Parámetros
metadata	Map

setFlashingResourcesRetriever

public abstract void setFlashingResourcesRetriever (IFlashingResourcesRetriever retriever)

Establece el mecanismo por el cual el programador puede recuperar archivos de recursos para la programación.

Parámetros
retriever	IFlashingResourcesRetriever: Es el IFlashingResourcesRetriever que se usará.

setForceSystemFlash

public abstract void setForceSystemFlash (boolean forceSystemFlash)

Establece si el sistema siempre debe escribirse en la memoria flash, incluso si se ejecuta la compilación actual.

setRamdiskPartition

public void setRamdiskPartition (String ramdiskPartition)

Establece la partición de ramdisk

setShouldFlashRamdisk

public void setShouldFlashRamdisk (boolean shouldFlashRamdisk)

Establece si se debe escribir un ramdisk adicional después de actualizar el dispositivo a través de un archivo zip de imagen.

setUserDataFlashOption

public abstract void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

Alterna si la imagen de datos del usuario se debe escribir en la memoria flash, borrar o conservar.

setWipeTimeout

public abstract void setWipeTimeout (long timeout)

Establece el tiempo de espera para borrar los datos.

Parámetros
timeout	long

shouldFlashRamdisk

public boolean shouldFlashRamdisk ()

Comprueba si el programador de memoria flash está configurado para que se escriba un disco RAM adicional después de actualizar el dispositivo a través de un archivo zip de imagen.

Muestra
boolean

supportsFlashingInFastbootD

public boolean supportsFlashingInFastbootD ()

Indica si se puede escribir en la memoria flash del dispositivo que implementa el flasher en modo fastbootd.

Muestra
boolean

tearDownFlasher

public void tearDownFlasher ()

Última oportunidad para que la implementación del flasher libere espacio