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)

Las memorias flash se compilan 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 conservar

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 llevarse a cabo antes de la sección crítica de la escritura en la memoria flash.

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 a través del cual el programador puede recuperar archivos de recursos para la actualización.

abstract void setForceSystemFlash(boolean forceSystemFlash)

Establece si el sistema debe instalarse siempre 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 instalar un ramdisk adicional después de actualizar el dispositivo mediante ZIP de imagen

abstract void setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption)

Activa o desactiva si se debe instalar, limpiar o retener la imagen de los datos del usuario

abstract void setWipeTimeout(long timeout)

Establece el tiempo de espera para borrar los datos.

default boolean shouldFlashRamdisk()

Comprueba si la memoria flash está configurada para tener un disco RAM adicional en la memoria flash después de actualizar el dispositivo mediante un archivo ZIP de imagen.

default boolean supportsFlashingInFastbootD()

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

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 la prueba.

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 si el dispositivo no responde

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 archivo, 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 del sistema principal.

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

Muestra
CommandStatus

getUserDataFlashOption

public abstract IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

Se obtiene si la imagen de los datos del usuario se debe instalar, limpiar o retener.

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

anulaciónDeviceOptions

public abstract void overrideDeviceOptions (ITestDevice device)

Anula las opciones de un dispositivo. Se usa para anular los valores predeterminados de las opciones si estos no son compatibles con un dispositivo en particular.

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. No se incluirá ninguna de esas operaciones en la sección crítica de simultaneidad controlada.

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 si el dispositivo no responde

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. No se incluirá ninguna de esas operaciones en la sección crítica de simultaneidad controlada.

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 si el dispositivo no responde

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 la escritura en la memoria flash puede recuperar archivos de recursos para escribir en la memoria flash.

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.

setDeberíaFlashRamdisk

public void setShouldFlashRamdisk (boolean shouldFlashRamdisk)

Establece si se debe instalar un ramdisk adicional después de actualizar el dispositivo mediante 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 ()

Comprueba si la memoria flash está configurada para tener un disco RAM adicional en la memoria flash después de actualizar el dispositivo mediante un archivo ZIP de imagen.

Muestra
boolean

supportsFlashingInFastbootD

public boolean supportsFlashingInFastbootD ()

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

Muestra
boolean