IDeviceFlasher

public interface IDeviceFlasher

com.android.tradefed.targetprep.IDeviceFlasher


Escribe en la memoria flash una imagen de un dispositivo.

Resumen

Métodos públicos

abstract void flash(ITestDevice device, IDeviceBuildInfo deviceBuild)

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

default getAdditionalFileFilters()

Obtén filtros para artefactos de compilación adicionales.

abstract CommandStatus getSystemFlashingStatus()

Recupera el estado de ejecución del comando para actualizar las particiones principales del sistema.

abstract IDeviceFlasher.UserDataFlashOption getUserDataFlashOption()

Obtiene si la imagen de datos del usuario se debe borrar, limpiar o retener.

abstract void overrideDeviceOptions(ITestDevice device)

Anula las opciones de un dispositivo.

default void postFlashOperations(ITestDevice device, IDeviceBuildInfo deviceBuild)

Todas las operaciones y verificaciones de limpieza que deben ocurrir después de la sección crítica de la actualización.

default void preFlashOperations(ITestDevice device, IDeviceBuildInfo deviceBuild)

Todas las operaciones y verificaciones de configuración que deben ocurrir antes de la sección crítica de la actualización.

abstract void setDataWipeSkipList( dataWipeSkipList)

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

Ten en cuenta que el nivel de detalle de la lista de omisión es de elementos secundarios directos de /data.

abstract void setFlashingResourcesRetriever(IFlashingResourcesRetriever retriever)

Establece el mecanismo mediante el cual el programador puede recuperar archivos de recursos para la actualización.

abstract void setForceSystemFlash(boolean forceSystemFlash)

Establece si el sistema siempre debe actualizarse, 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 en la memoria flash un ramdisk adicional después de actualizar el dispositivo a través de un archivo zip de imagen.

abstract void setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption)

Activa o desactiva si la imagen de datos del usuario se debe borrar, conservar o actualizar

abstract void setWipeTimeout(long timeout)

Establece el tiempo de espera para borrar los datos.

default boolean shouldFlashRamdisk()

Verifica si el programador está configurado para que se escriba un ramdisk adicional después de actualizar el dispositivo a través de un archivo ZIP de imagen.

default boolean supportsFlashingInFastbootD()

Indica si el dispositivo que implementa el programador de memoria flash se puede escribir en el modo fastbootd.

default void tearDownFlasher()

Es la última oportunidad para que la implementación del activador de luces se limpie.

Métodos públicos

flash

public abstract void flash (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

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

Se muestra inmediatamente después de que se completa el proceso de actualización. Los emisores deben esperar a que el dispositivo esté en línea y disponible antes de continuar con las pruebas.

Parámetros
device ITestDevice: Es el ITestDevice que se debe actualizar.

deviceBuild IDeviceBuildInfo: Es el IDeviceBuildInfo que se debe actualizar.

Arroja
TargetSetupError si no se pudo escribir en la memoria flash la compilación
DeviceNotAvailableException if device becomes unresponsive

getAdditionalFileFilters

public  getAdditionalFileFilters ()

Obtén filtros para artefactos de compilación adicionales.

Algunos programadores de memoria flash necesitan ciertos artefactos de compilación que no se encuentran entre los predeterminados que se usan. Estos programadores deben anular este método, de modo que cada usuario de las herramientas de programación no necesite 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 proporcionado 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 muestra un conjunto vacío.

Muestra

getSystemFlashingStatus

public abstract CommandStatus getSystemFlashingStatus ()

Recupera el estado de ejecución del comando para actualizar las particiones principales del sistema.

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 la imagen de datos del usuario se debe borrar, limpiar o retener.

Muestra
IDeviceFlasher.UserDataFlashOption Si la imagen de datos del usuario se debe borrar, limpiar o conservar

overrideDeviceOptions

public abstract void overrideDeviceOptions (ITestDevice device)

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

postFlashOperations

public void postFlashOperations (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

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

Parámetros
device ITestDevice: Es el ITestDevice que se debe actualizar.

deviceBuild IDeviceBuildInfo: Es el IDeviceBuildInfo que se debe actualizar.

Arroja
TargetSetupError si falla alguna configuración
DeviceNotAvailableException if device becomes unresponsive

preFlashOperations

public void preFlashOperations (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

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

Parámetros
device ITestDevice: Es el ITestDevice que se debe actualizar.

deviceBuild IDeviceBuildInfo: Es el IDeviceBuildInfo que se debe actualizar.

Arroja
TargetSetupError si falla alguna configuración
DeviceNotAvailableException if device becomes unresponsive

setDataWipeSkipList

public abstract void setDataWipeSkipList ( dataWipeSkipList)

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

Ten en cuenta que el nivel de detalle de la lista de omisión es de elementos secundarios directos de /data.

Parámetros
dataWipeSkipList

setFlashingResourcesRetriever

public abstract void setFlashingResourcesRetriever (IFlashingResourcesRetriever retriever)

Establece el mecanismo mediante el cual el programador puede recuperar archivos de recursos para la actualización.

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

setForceSystemFlash

public abstract void setForceSystemFlash (boolean forceSystemFlash)

Establece si el sistema siempre debe actualizarse, 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 en la memoria flash 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)

Activa o desactiva si la imagen de datos del usuario se debe borrar, conservar o actualizar

setWipeTimeout

public abstract void setWipeTimeout (long timeout)

Establece el tiempo de espera para borrar los datos.

Parámetros
timeout long

shouldFlashRamdisk

public boolean shouldFlashRamdisk ()

Verifica si el programador está configurado para que se escriba un ramdisk adicional después de actualizar el dispositivo a través de un archivo ZIP de imagen.

Muestra
boolean

supportsFlashingInFastbootD

public boolean supportsFlashingInFastbootD ()

Indica si el dispositivo que implementa el programador de memoria flash se puede escribir en el modo fastbootd.

Muestra
boolean

tearDownFlasher

public void tearDownFlasher ()

Es la última oportunidad para que la implementación del activador de luces se limpie.