A partir de 2026, para alinearnos con nuestro modelo de desarrollo estable de la rama principal y garantizar la estabilidad de la plataforma para el ecosistema, publicaremos el código fuente en AOSP en el segundo y cuarto trimestre. Para compilar AOSP y contribuir a él, te recomendamos que utilices android-latest-release en lugar de aosp-main. La rama del manifiesto android-latest-release siempre hará referencia a la versión más reciente que se envió al AOSP. Para obtener más información, consulta Cambios en AOSP.

IDeviceFlasher

public interface IDeviceFlasher

com.android.tradefed.targetprep.IDeviceFlasher

Subcategorías indirectas conocidas

CdmaDeviceFlasher, FastbootDeviceFlasher, OtaUpdateDeviceFlasher, SystemUpdaterDeviceFlasher

CdmaDeviceFlasher	Es una 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 programador de memoria flash de dispositivos 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
`abstract void`	`flash(ITestDevice device, IDeviceBuildInfo deviceBuild)` Escribe la compilación en la memoria flash del dispositivo.
`default`	`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 la imagen de datos del usuario se debe escribir en la memoria flash, borrar o conservar.
`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 ocurrir antes de la sección crítica de escritura real.
`abstract void`	`setDataWipeSkipList( 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( 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 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 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()` Verifica si el programador de memoria flash está configurado para que se escriba una RAMDisk 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 se limpie

Métodos públicos

flash

public abstract void flash (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

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

Devuelve el control 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 las pruebas.

Parámetros
`device`	`ITestDevice`: El `ITestDevice` que se mostrará
`deviceBuild`	`IDeviceBuildInfo`: El `IDeviceBuildInfo` que se mostrará

Arroja
`TargetSetupError`	Si no se pudo escribir la compilación en la memoria flash
`DeviceNotAvailableException`	Si el dispositivo deja de responder

getAdditionalFileFilters

public  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

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 la imagen de datos del usuario se debe escribir en la memoria flash, borrar o conservar.

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 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 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 mostrará
`deviceBuild`	`IDeviceBuildInfo`: El `IDeviceBuildInfo` que se mostrará

Arroja
`TargetSetupError`	Si falla alguna configuración
`DeviceNotAvailableException`	Si el dispositivo deja de responder

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 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 mostrará
`deviceBuild`	`IDeviceBuildInfo`: El `IDeviceBuildInfo` que se mostrará

Arroja
`TargetSetupError`	Si falla alguna configuración
`DeviceNotAvailableException`	Si el dispositivo deja de responder

setDataWipeSkipList

public abstract void setDataWipeSkipList ( 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`

setExtraMetadata

public void setExtraMetadata ( metadata)

Permite que el flasher reciba opciones de metadatos adicionales.

Parámetros
`metadata`

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`: 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 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 tener un disco RAM adicional que se debe escribir en la memoria flash 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 se limpie a sí misma